{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-@l10n/zh/api/liveops/index.yaml","sidebar":"sidebar-@l10n/zh/liveops-en.sidebars.yaml"},"props":{"definitionId":"@l10n/zh/api/liveops/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/zh/api/liveops","seo":{"title":"概述","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"Reward chains encourage users to make purchases in the store using real currency. For each purchase, users earn value points and progress through a reward chain. If users are part of clans, their purchases contribute value points to the entire clan. For detailed information on configuring the reward chains, refer to the [Reward system](https://developers.xsolla.com/zh/liveops/promotion-tools/reward-system/) section.\n\nTo configure reward chains, use API calls from the **Admin** subsection. To display chains and claim rewards, use API calls from the **Client** subsection. To work with clan reward chains, use API calls from the **Clans client** subsection.\n\n<b>Example of reward chain configuration flow:</b>\n\n1. Create items using the API calls from the **Admin** subsection of the [Virtual items and currency](https://developers.xsolla.com/zh/api/catalog/virtual-items-currency-overview) or [Bundles](https://developers.xsolla.com/zh/api/catalog/bundles-admin) groups.\n2. Create value points using the [Create value point](https://developers.xsolla.com/zh/api/liveops/reward-chain-value-points-admin/admin-create-value-points) API call.\n3. Assign value points to items using the [Set value points for items](https://developers.xsolla.com/zh/api/liveops/reward-chain-value-points-admin/admin-set-items-value-point-reward) API call. Users receive value points after purchasing these items.\n4. Create a chain using the [Create reward chain](https://developers.xsolla.com/zh/api/liveops/reward-chain-value-points-admin/admin-create-reward-chain) API call. To activate the chain, pass the `is_enabled: true` parameter.\n5. Implement reward chain display. To do this, request the list of available chains using the [Get current user's reward chains](https://developers.xsolla.com/zh/api/liveops/reward-chain-client/get-reward-chains-list) API call. The response contains all active chains with their steps and statuses.\n6. Implement value point balance display. To do this, use the [Get current user's value point balance](https://developers.xsolla.com/zh/api/liveops/reward-chain-client/get-user-reward-chain-balance) API call.\n7. Implement step reward claiming. To do this, use the [Claim step reward](https://developers.xsolla.com/zh/api/liveops/reward-chain-client/claim-user-reward-chain-step-reward) API call.\n8. Configure order status tracking, e.g., using [webhooks](https://developers.xsolla.com/zh/webhooks/section/overview), to promptly receive data on claimed rewards and grant them to the user.\n\n![Reward chain configuration flow](https://cdn.xsolla.net/developers/current/images/api_docs/reward-chains-and-value-points-overview.svg)"},"itemId":"reward-chain-value-points-overview","disableAutoScroll":true,"metadata":{},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"xsolla.redocly.app","port":4000,"ipAddress":"216.73.216.14"},"lang":"zh","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/zh/api/liveops/reward-chain-value-points-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}