# LiveOps API # Overview * **Version:** 2.0.0 * **Servers**: `https://store.xsolla.com/api` * **[Contact Us by Email](mailto:integration@xsolla.com)** * **Contact URL:** https://xsolla.com/ * **Required TLS version:** 1.2 LiveOps API fornece endpoints para aumentar o engajamento dos jogadores. Version: 2.0.0 ## Servers ``` https://store.xsolla.com/api ``` ## Security ### AuthForCart Ao vender um carrinho com jogos, você pode [chamar o ponto de extremidade sem autorização](/pt/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users). Para fazer isso: * Adicione um identificador exclusivo ao parâmetro `x-unauthorized-id` no cabeçalho dos jogos. * Adicione o e-mail do usuário ao parâmetro `x-user` (codificado em Base64) no cabeçalho dos jogos. Por padrão, o Xsolla Login User JWT (Bearer token) é usado para autorização. Você pode tentar chamar esse ponto de extremidade com um token de testes Xsolla Login User JWT: `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`. Você pode usar o [token de acesso Pay Station](https://developers.xsolla.com/pt/api/pay-station/operation/create-token/) como uma alternativa. Type: http Scheme: bearer ### XsollaLoginUserJWT Por padrão, o Xsolla Login User JWT (Bearer token) é usado para autorização. Você pode tentar chamar esse ponto de extremidade com um token de testes Xsolla Login User JWT: `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`. Você pode usar o [token de acesso Pay Station](https://developers.xsolla.com/pt/api/pay-station/operation/create-token/) como uma alternativa. Type: http Scheme: bearer Bearer Format: JWT ### basicAuth A Xsolla API usa autenticação de acesso básica. Todas as solicitações à API devem conter o cabeçalho `Authorization: Basic `, onde `your_authorization_basic_key` é o par codificado `project_id:api_key` de acordo com o padrão Base64. Você pode usar `merchant_id` em vez de `project_id` se precisar. Isso não afeta a funcionalidade. Vá para a [Conta de Distribuidor](https://publisher.xsolla.com/) para encontrar valores dos parâmetros: * `merchant_id` é mostrado: * Na seção **Configurações da empresa > Empresa** * Na URL na barra de endereço do navegador em qualquer página de conta de editor. O URL tem o seguinte formato: `https://publisher.xsolla.com/`. * `api_key` é exibida na Conta de Distribuidor apenas uma vez quando é criada e deve ser armazenada do seu lado. Você pode criar uma nova chave na seção a seguir: * **Configurações da empresa > Chaves API** * **Configurações do projeto > Chaves API** * `project_id` é mostrado: * Na Conta de Distribuidor ao lado do nome do projeto. * Na URL na barra de endereços do navegador ao trabalhar no projeto na Conta do Publicador. O URL tem o seguinte formato: `https://publisher.xsolla.com//projects/`. Para obter mais informações sobre como trabalhar com chaves API, consulte a [Referência de API](https://developers.xsolla.com/pt/api/getting-started/#api_keys_overview). Type: http Scheme: basic ### basicMerchantAuth A Xsolla API usa autenticação de acesso básica. Todas as solicitações à API devem conter o cabeçalho `Authorization: Basic `, onde `your_authorization_basic_key` é o par codificado `merchant_id:api_key` de acordo com o padrão Base64. Vá para a [Conta de Distribuidor](https://publisher.xsolla.com/) para encontrar valores dos parâmetros: * `merchant_id` é mostrado: * Na seção **Configurações da empresa > Empresa** * Na URL na barra de endereço do navegador em qualquer página de conta de editor. O URL tem o seguinte formato: `https://publisher.xsolla.com/` * `api_key` é exibida na Conta de Distribuidor apenas uma vez quando é criada e deve ser armazenada do seu lado. Você pode criar uma nova chave na seção a seguir: * **Configurações da empresa > Chaves API** * **Configurações do projeto > Chaves API** Para obter mais informações sobre como trabalhar com chaves API, consulte a [Referência de API](https://developers.xsolla.com/pt/api/getting-started/#api_keys_overview). Type: http Scheme: basic ## Download OpenAPI description [LiveOps API](https://developers.xsolla.com/_bundle/@l10n/pt/api/liveops/index.yaml) ## Comum ### Ativar promoção - [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/activate](https://developers.xsolla.com/pt/api/liveops/promotions-common/activate-promotion.md): Ativa uma promoção. ### Desativar promoção - [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/deactivate](https://developers.xsolla.com/pt/api/liveops/promotions-common/deactivate-promotion.md): Desativa uma promoção. ### Verificar o código promocional - [GET /v2/project/{project_id}/promotion/code/{code}/verify](https://developers.xsolla.com/pt/api/liveops/promotions-common/verify-promotion-code.md): Determina se o código é um código promocional ou código de cupom e se o usuário pode aplicá-lo. ### Obter toda a lista de promoções - [GET /v3/project/{project_id}/admin/promotion](https://developers.xsolla.com/pt/api/liveops/promotions-common/get-promotion-list.md): Obtém a lista de promoções de um projeto. ### Obtenha promoção resgatável por código - [GET /v3/project/{project_id}/admin/promotion/redeemable/code/{code}](https://developers.xsolla.com/pt/api/liveops/promotions-common/get-redeemable-promotion-by-code.md): Obtém a promoção por um código promocional ou código de cupom. ## Cupons Esta API permite que você gerencie cupons. ### Obtenha limites de código de cupom exclusivos - [GET /v2/project/{project_id}/admin/code/limit/coupon/external_id/{external_id}](https://developers.xsolla.com/pt/api/liveops/promotions-coupons/get-coupon-code-limit.md): Obtém o número restante de vezes que os códigos podem ser usados. Para filtrar os códigos, use o parâmetro de pesquisa codes. Para configurar o limite de código em si, vá para a seção Admin: * Coupons ### Ativar promoção de cupom - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/activate](https://developers.xsolla.com/pt/api/liveops/promotions-coupons/activate-coupon.md): Ativa uma promoção de cupom. A promoção de cupom criada está desabilitada por padrão. Ele não estará pronto para resgate até que você o ative. Use esse ponto de extremidade para habilitar e ativar uma promoção de cupom. ### Obter códigos de cupom - [GET /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/pt/api/liveops/promotions-coupons/get-coupon-codes.md): Obtém códigos de cupom. ### Criar código de cupom - [POST /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/pt/api/liveops/promotions-coupons/create-coupon-code.md): Cria código de cupom. ### Gerar códigos de cupom - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/code/generate](https://developers.xsolla.com/pt/api/liveops/promotions-coupons/generate-coupon-codes.md): Gera códigos de cupom. ### Desativar promoção de cupom - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/deactivate](https://developers.xsolla.com/pt/api/liveops/promotions-coupons/deactivate-coupon.md): Desativa uma promoção de cupom. A promoção de cupom criada está desabilitada por padrão. Ele não estará pronto para resgate até que você o ative. Use esse ponto de extremidade para desativar e desativar uma promoção de cupom. ### Obter limite de cupons de um usuário específico - [GET /v2/project/{project_id}/admin/user/limit/coupon/external_id/{external_id}](https://developers.xsolla.com/pt/api/liveops/promotions-coupons/get-coupon-user-limit.md): Obtém o número restante de vezes que o usuário especificado pode usar o cupom. A API User limit permite limitar o número de vezes que os usuários podem usar um cupom. Para configurar o próprio limite de usuário, vá para a seção Admin: * Cupons ### Obter recompensas de cupom - [GET /v2/project/{project_id}/coupon/code/{coupon_code}/rewards](https://developers.xsolla.com/pt/api/liveops/promotions-coupons/get-coupon-rewards-by-code.md): Recebe cupons de recompensa por seu código. Pode ser usado para permitir que os usuários escolham um dos muitos itens como bônus. O caso usual é escolher um DRM se o cupom contiver um jogo como bônus (type=unit). ### Resgatar código de cupom - [POST /v2/project/{project_id}/coupon/redeem](https://developers.xsolla.com/pt/api/liveops/promotions-coupons/redeem-coupon.md): Resgata um código de cupom. O usuário recebe um bônus depois que um cupom é resgatado. ### Obter lista de promoções de cupons - [GET /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/pt/api/liveops/promotions-coupons/get-coupons.md): Obtém a lista de promoções de cupons de um projeto. ### Criar promoção de cupom - [POST /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/pt/api/liveops/promotions-coupons/admin-create-coupon.md): Cria uma promoção de cupom. ### Excluir promoção de cupom - [DELETE /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/pt/api/liveops/promotions-coupons/delete-coupon-promotion.md): Exclui a promoção de cupom. A promoção excluída: * Desaparece da lista de promoções configuradas em seu projeto. * Não é mais aplicada ao catálogo de itens. O usuário não pode obter itens bônus com esta promoção. Após a exclusão, a promoção não pode ser restaurada. Os códigos de cupom da promoção excluída podem ser adicionados às promoções existentes. ### Ganhe promoção de cupom - [GET /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/pt/api/liveops/promotions-coupons/get-coupon.md): Obtém uma promoção de cupom especificada. ### Promoção de cupom de atualização - [PUT /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/pt/api/liveops/promotions-coupons/update-coupon-promotion.md): Atualiza uma promoção de cupom. ## Códigos promocionais Esta API permite gerenciar códigos promocionais. ### Obter limite de código promocional para códigos - [GET /v2/project/{project_id}/admin/code/limit/promocode/external_id/{external_id}](https://developers.xsolla.com/pt/api/liveops/promotions-promo-codes/get-promo-code-code-limit.md): Obtém o número restante de vezes que os códigos podem ser usados. Para filtrar os códigos, use o parâmetro de consulta codes. Para configurar o limite de código em si, vá para a seção Admin: * Promo Codes ### Ativar promoção de código promocional - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/activate](https://developers.xsolla.com/pt/api/liveops/promotions-promo-codes/activate-promo-code.md): Ativa uma promoção de código promocional. A promoção de código promocional criada inicia desativada por padrão. Ele não estará pronto para resgate até que você o ative. Use esse ponto de extremidade para habilitar e ativar uma promoção de código promocional. ### Obter códigos de promoção de código promocional - [GET /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/pt/api/liveops/promotions-promo-codes/get-promocode-codes.md): Obtém códigos de uma promoção de código promocional. ### Criar código para promoção de código promocional - [POST /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/pt/api/liveops/promotions-promo-codes/create-promo-code-code.md): Cria código para uma promoção de código promocional. ### Gerar códigos para promoção de código promocional - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/code/generate](https://developers.xsolla.com/pt/api/liveops/promotions-promo-codes/generate-promo-code-codes.md): Gera códigos para uma promoção de código promocional. ### Desativar promoção de código promocional - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/deactivate](https://developers.xsolla.com/pt/api/liveops/promotions-promo-codes/deactivate-promo-code.md): Desativa uma promoção de código promocional. A promoção de código promocional criada inicia desativada por padrão. Ele não estará pronto para resgate até que você o ative. Use esse ponto de extremidade para desabilitar e desativar uma promoção de código promocional. ### Obter limite de código promocional para o usuário especificado - [GET /v2/project/{project_id}/admin/user/limit/promocode/external_id/{external_id}](https://developers.xsolla.com/pt/api/liveops/promotions-promo-codes/get-promo-code-user-limit.md): Obtém o número restante de vezes que o usuário especificado pode usar o código promocional. A API User limit permite limitar o número de vezes que os usuários podem usar um código promocional. Para configurar o limite de usuário em si, vá para a seção Admin: * Códigos Promocionais ### Obter recompensas de código promocional - [GET /v2/project/{project_id}/promocode/code/{promocode_code}/rewards](https://developers.xsolla.com/pt/api/liveops/promotions-promo-codes/get-promo-code-rewards-by-code.md): Recebe recompensas de código promocional pelo seu código. Pode ser usado para permitir que os usuários escolham um dos muitos itens como bônus. O caso usual é escolher um DRM se o código promocional contiver um jogo como bônus (type=unit). ### Resgatar código promocional - [POST /v2/project/{project_id}/promocode/redeem](https://developers.xsolla.com/pt/api/liveops/promotions-promo-codes/redeem-promo-code.md): Resgata um código promocional de promoção. Depois de resgatar um código promocional, o usuário receberá itens gratuitos e/ou o preço do carrinho e/ou itens específicos será diminuído. ### Remover código promocional do carrinho - [PUT /v2/project/{project_id}/promocode/remove](https://developers.xsolla.com/pt/api/liveops/promotions-promo-codes/remove-cart-promo-code.md): Remove um código promocional de um carrinho. Depois que o código promocional for removido, o preço total de todos os itens no carrinho será recalculado sem bônus e descontos fornecidos por um código promocional. ### Obter lista de promoções de códigos promocionais - [GET /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/pt/api/liveops/promotions-promo-codes/get-promo-codes.md): Obtém a lista de códigos promocionais de um projeto. ### Criar promoção de código promocional - [POST /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/pt/api/liveops/promotions-promo-codes/create-promo-code.md): Cria uma promoção de código promocional. ### Excluir promoção de código promocional - [DELETE /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/pt/api/liveops/promotions-promo-codes/delete-promo-code.md): Exclui a promoção de código promocional. A promoção excluída: * Desaparece da lista de promoções configuradas em seu projeto. * Não é mais aplicada ao catálogo de itens e ao carrinho. O usuário não pode obter itens bônus ou comprar itens usando esta promoção. Após a exclusão, a promoção não pode ser restaurada. Os códigos promocionais da promoção excluída podem ser adicionados às promoções existentes. ### Obter promoção de código promocional - [GET /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/pt/api/liveops/promotions-promo-codes/get-promo-code.md): Obtém uma promoção de código promocional especificada. ### Atualizar promoção de código promocional - [PUT /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/pt/api/liveops/promotions-promo-codes/update-promo-code.md): Atualiza uma promoção de código promocional. ## Ofertas de catálogo exclusivas Essa API permite que você gerencie ofertas de catálogo exclusivas. ### Ativar promoção de oferta de catálogo exclusiva - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/activate](https://developers.xsolla.com/pt/api/liveops/promotions-unique-catalog-offers/activate-unique-catalog-offer.md): Ativa uma promoção de oferta de catálogo exclusiva. A promoção de oferta de catálogo exclusiva criada está desativada por padrão. Ele não pode ser resgatado até que você o ative. Use esse ponto de extremidade para habilitar e ativar uma promoção de cupom. ### Obtenha códigos de oferta de catálogo exclusivos - [GET /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code](https://developers.xsolla.com/pt/api/liveops/promotions-unique-catalog-offers/get-unique-catalog-offer-codes.md): Obtém códigos de oferta de catálogo exclusivos. ### Criar código de oferta de catálogo exclusivo - [POST /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code](https://developers.xsolla.com/pt/api/liveops/promotions-unique-catalog-offers/create-unique-catalog-offer-code.md): Cria um código de oferta de catálogo exclusivo. ### Gerar códigos de oferta de catálogo exclusivos - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code/generate](https://developers.xsolla.com/pt/api/liveops/promotions-unique-catalog-offers/generate-unique-catalog-offer-codes.md): Gera códigos de oferta de catálogo exclusivos. ### Desativar promoção exclusiva de oferta de catálogo - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/deactivate](https://developers.xsolla.com/pt/api/liveops/promotions-unique-catalog-offers/deactivate-unique-catalog-offer.md): Desativa uma promoção exclusiva de oferta de catálogo. A promoção exclusiva de oferta de catálogo criada está desativada por padrão. Ela não pode ser resgatada até que você a ative. Use esse ponto de extremidade para desativar e desativar uma promoção de cupom. ### Obter lista de promoções exclusivas de ofertas de catálogo - [GET /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/pt/api/liveops/promotions-unique-catalog-offers/get-unique-catalog-offers.md): Obtém a lista de promoções de ofertas de catálogo exclusivas de um projeto. ### Criar promoção de oferta de catálogo exclusiva - [POST /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/pt/api/liveops/promotions-unique-catalog-offers/admin-create-unique-catalog-offer.md): Cria uma promoção exclusiva de oferta de catálogo. ### Excluir promoção de oferta de catálogo exclusiva - [DELETE /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/pt/api/liveops/promotions-unique-catalog-offers/delete-unique-catalog-offer-promotion.md): Exclui a promoção de oferta de catálogo único. A promoção excluída: * Desaparece da lista de promoções configuradas no seu projeto. * Não se aplica mais ao catálogo de itens e ao carrinho. O usuário não pode comprar itens com esta promoção. Após a exclusão, a promoção não poderá ser restaurada. ### Obter promoção de oferta de catálogo exclusiva - [GET /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/pt/api/liveops/promotions-unique-catalog-offers/get-unique-catalog-offer.md): Obtém a promoção de oferta de catálogo exclusiva especificada. ### Atualiza a promoção de oferta de catálogo exclusiva - [PUT /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/pt/api/liveops/promotions-unique-catalog-offers/update-unique-catalog-offer-promotion.md): Atualiza a promoção de oferta de catálogo exclusiva. ## Descontos Esta API permite-lhe gerir promoções de desconto. ### Obter lista de promoções de itens - [GET /v3/project/{project_id}/admin/promotion/item](https://developers.xsolla.com/pt/api/liveops/promotions-discounts/get-item-promotion-list.md): Obtenha a lista de promoções de itens de um projeto. As promoções oferecem um desconto (%) nos itens. O desconto será aplicado a todos os preços dos itens especificados. ### Criar promoção de desconto para item - [POST /v3/project/{project_id}/admin/promotion/item](https://developers.xsolla.com/pt/api/liveops/promotions-discounts/create-item-promotion.md): Cria uma promoção de desconto para um item. As promoções oferecem um desconto (%) nos itens. O desconto será aplicado a todos os preços dos itens especificados. ### Excluir promoção de item - [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/pt/api/liveops/promotions-discounts/delete-item-promotion.md): Exclui a promoção de desconto. A promoção excluída: * Desaparece da lista de promoções configuradas no seu projeto. * Não se aplica mais ao catálogo de itens e ao carrinho. O usuário não pode comprar itens com esta promoção. Após a exclusão, a promoção não poderá ser restaurada. ### Obter promoção de itens - [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/pt/api/liveops/promotions-discounts/get-item-promotion.md): Obtém a promoção aplicada a itens específicos. As promoções oferecem um desconto (%) nos itens. O desconto será aplicado a todos os preços dos itens especificados. ### Atualizar promoção de item - [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/pt/api/liveops/promotions-discounts/update-item-promotion.md): Atualiza a promoção. ObservaçãoNovos dados substituirão dados antigos. Se você quiser atualizar apenas uma parte de uma promoção, você deve transferir todos os dados necessários na solicitação também. As promoções oferecem um desconto (%) nos itens. O desconto será aplicado a todos os preços dos itens especificados. ## Bônus Esta API permite gerenciar promoções de bônus. ### Obter lista de promoções de bônus - [GET /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/pt/api/liveops/promotions-bonuses/get-bonus-promotion-list.md): Obtém a lista de promoções bônus de um projeto. A promoção adiciona itens bônus gratuitos à compra feita por um usuário. A promoção pode ser aplicada a cada compra dentro de um projeto ou a uma compra que inclua itens específicos. ### Criar promoção de bônus - [POST /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/pt/api/liveops/promotions-bonuses/create-bonus-promotion.md): Cria a promoção de bônus. A promoção adiciona itens bônus gratuitos à compra feita por um usuário. A promoção pode ser aplicada a cada compra dentro de um projeto ou a uma compra que inclua itens específicos. ### Excluir promoção bônus - [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/pt/api/liveops/promotions-bonuses/delete-bonus-promotion.md): Exclui a promoção bônus. A promoção excluída: * Desaparece da lista de promoções configuradas no seu projeto. * Não se aplica mais ao catálogo de itens e ao carrinho. O usuário não pode obter itens bônus com esta promoção. Após a exclusão, a promoção não poderá ser restaurada. ### Obter promoção bônus - [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/pt/api/liveops/promotions-bonuses/get-bonus-promotion.md): Recebe a promoção bônus. A promoção adiciona itens bônus gratuitos à compra feita por um usuário. A promoção pode ser aplicada a cada compra dentro de um projeto ou a uma compra que inclua itens específicos. ### Atualizar promoção bônus - [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/pt/api/liveops/promotions-bonuses/update-bonus-promotion.md): Atualiza a promoção. ObservaçãoNovos dados substituirão dados antigos. Se você quiser atualizar apenas uma parte de uma promoção, você deve transferir todos os dados necessários na solicitação também. A promoção adiciona itens bônus gratuitos à compra feita por um usuário. A promoção pode ser aplicada a cada compra dentro de um projeto ou a uma compra que inclua itens específicos. ## Catálogo personalizado Essa API permite especificar regras para atributos de usuário. Se o usuário atender a todas as condições para uma regra concreta, serão exibidos itens personalizados. Para promoções personalizadas, consulte a [seção Promotions](/pt/api/shop-builder/tag/promotions-discounts). Para passar atributos antes de uma compra, você pode usar a [Xsolla Login API](/pt/api/login/operation/update-users-attributes-from-server/) ou passá-los para a [propriedade user.attributes ao gerar o token usando a Pay Station API](/pt/api/pay-station/operation/create-token). ### Obter lista de regras de filtro de catálogo - [GET /v2/project/{project_id}/admin/user/attribute/rule](https://developers.xsolla.com/pt/api/liveops/personalized-catalog/get-filter-rules.md): Obtém todas as regras aplicadas aos atributos do usuário. ### Criar regra de filtro de catálogo - [POST /v2/project/{project_id}/admin/user/attribute/rule](https://developers.xsolla.com/pt/api/liveops/personalized-catalog/create-filter-rule.md): Criar regra para atributos de usuário. ### Obter todas as regras de catálogo para pesquisa no lado do cliente - [GET /v2/project/{project_id}/admin/user/attribute/rule/all](https://developers.xsolla.com/pt/api/liveops/personalized-catalog/get-all-filter-rules.md): Obtém uma lista de todas as regras de catálogo para pesquisa no lado do cliente. AtençãoRetorna apenas ID de regra, nome e is_enabled ### Regra de filtro de exclusão de catálogo - [DELETE /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/pt/api/liveops/personalized-catalog/delete-filter-rule-by-id.md): Exclui uma regra específica. ### Obter regra de filtro de catálogo - [GET /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/pt/api/liveops/personalized-catalog/get-filter-rule-by-id.md): Obtenha regras específicas aplicáveis aos atributos do usuário. ### Regra de filtro do catálogo de atualizações - [PATCH /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/pt/api/liveops/personalized-catalog/patch-filter-rule-by-id.md): Atualiza uma regra específica que se aplica aos atributos do usuário. O valor atual será usado para uma propriedade não especificada. ### Atualizar regra de filtro de catálogo - [PUT /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/pt/api/liveops/personalized-catalog/update-filter-rule-by-id.md): Atualiza uma regra específica que se aplica aos atributos do usuário. O valor padrão será usado para uma propriedade não especificada (se a propriedade não for necessária). ## Gestão ### Atualizar todos os limites de promoção para o usuário especificado - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/all](https://developers.xsolla.com/pt/api/liveops/user-limits-admin/reset-all-user-promotions-limit.md): Atualiza todos os limites em todas as promoções para o usuário especificado para que ele possa usar essas promoções novamente. A API User limit permite limitar o número de vezes que os usuários podem usar uma promoção. Para configurar o limite de usuário em si, vá para a seção Admin do tipo de promoção desejado: * Promoções de Desconto * Promoções de Bônus ### Diminuir o limite de promoção para o usuário especificado - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/pt/api/liveops/user-limits-admin/remove-user-promotion-limit.md): Diminui o número restante de vezes que o usuário especificado pode usar uma promoção dentro do limite aplicado. A API User limit permite limitar o número de vezes que os usuários podem usar uma promoção. Para configurar o limite de usuário em si, vá para a seção Admin do tipo de promoção desejado: * Promoções de Desconto * Promoções de Bônus ### Obter limite de promoção para o usuário especificado - [GET /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/pt/api/liveops/user-limits-admin/get-user-promotion-limit.md): Obtém o número restante de vezes que o usuário especificado pode usar a promoção dentro do limite aplicado. A API User limit permite limitar o número de vezes que os usuários podem usar uma promoção. Para configurar o limite de usuário em si, vá para a seção Admin do tipo de promoção desejado: * Promoções de Desconto * Promoções de Bônus ### Aumentar o limite de promoção para o usuário especificado - [POST /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/pt/api/liveops/user-limits-admin/add-user-promotion-limit.md): Aumenta o número restante de vezes que o usuário especificado pode usar a promoção dentro do limite aplicado. A API User limit permite limitar o número de vezes que os usuários podem usar uma promoção. Para configurar o limite de usuário em si, vá para a seção Admin do tipo de promoção desejado: * Promoções de Desconto * Promoções de Bônus ### Definir limite de promoção para o usuário especificado - [PUT /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/pt/api/liveops/user-limits-admin/set-user-promotion-limit.md): Define o número de vezes que o usuário especificado pode usar uma promoção dentro do limite aplicado depois que ela foi aumentada ou diminuída. A API User limit permite limitar o número de vezes que os usuários podem usar uma promoção. Para configurar o limite de usuário em si, vá para a seção Admin do tipo de promoção desejado: * Promoções de Desconto * Promoções de Bônus ### Atualizar limite de promoção para usuários - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}/all](https://developers.xsolla.com/pt/api/liveops/user-limits-admin/reset-user-promotion-limit.md): Atualiza o limite da promoção para que um usuário possa usar essa promoção novamente. Se o parâmetro user for null, essa chamada atualizará esse limite para todos os usuários. A API User limit permite limitar o número de vezes que os usuários podem usar uma promoção. Para configurar o limite de usuário em si, vá para a seção Admin do tipo de promoção desejado: * Promoções de Desconto * Promoções de Bônus ## Admin ### Obter lista de pontos de valor - [GET /v2/project/{project_id}/admin/items/value_points](https://developers.xsolla.com/pt/api/liveops/reward-chain-value-points-admin/admin-get-value-points-list.md): Obtém a lista de pontos de valor dentro de um projeto para administração. ### Criar ponto de valor - [POST /v2/project/{project_id}/admin/items/value_points](https://developers.xsolla.com/pt/api/liveops/reward-chain-value-points-admin/admin-create-value-points.md): Cria um ponto de valor. ### Excluir pontos de valor - [DELETE /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/pt/api/liveops/reward-chain-value-points-admin/admin-delete-value-point.md): Exclui um ponto de valor identificado por um SKU. ### Obter ponto de valor - [GET /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/pt/api/liveops/reward-chain-value-points-admin/admin-get-value-point.md): Obtém um ponto de valor pelo SKU dentro de um projeto para administração. ### Atualizar ponto de valor - [PUT /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/pt/api/liveops/reward-chain-value-points-admin/admin-update-value-point.md): Atualiza um ponto de valor identificado por um SKU. ### Excluir pontos de valor de itens - [DELETE /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/pt/api/liveops/reward-chain-value-points-admin/admin-delete-items-value-point-reward.md): Remove recompensas de pontos de valor de TODOS os itens. ### Obter lista de itens com pontos de valor - [GET /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/pt/api/liveops/reward-chain-value-points-admin/admin-get-items-value-point-reward.md): Obtém a lista de todos os itens com pontos de valor dentro de um projeto para administração. ### Atualizar parcialmente os pontos de valor dos itens - [PATCH /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/pt/api/liveops/reward-chain-value-points-admin/admin-patch-items-value-point-reward.md): Atualiza parcialmente o número de pontos de valor para um ou mais itens pelo SKU do item. Os usuários recebem esses pontos de valor após a compra dos itens especificados. Princípios de atualização de pontos de valor: * Se um item ainda não tiver pontos de valor, enviar um valor diferente de zero no campo amount os criará. * Se um item já tiver pontos de valor, o envio de um valor diferente de zero no campo amount os atualizará. * Se amount for definido como 0, os pontos de valor existentes para esse item serão excluídos. Ao contrário do método PUT (Definir pontos de valor para itens), este método PATCH não sobrescreve todos os pontos de valor existentes dos itens no projeto, apenas atualiza os itens especificados. Uma única solicitação pode atualizar até 100 itens. SKUs de itens duplicados não podem ser incluídos na mesma solicitação. ### Definir pontos de valor para itens - [PUT /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/pt/api/liveops/reward-chain-value-points-admin/admin-set-items-value-point-reward.md): Atribui pontos de valor a um ou vários itens por um SKU. Os usuários recebem pontos de valor depois de comprar esses itens. Observe que essa solicitação PUT substitui todos os pontos de valor definidos anteriormente para itens no projeto. Para evitar a exclusão não intencional de pontos de valor, inclua todos os itens e seus respectivos pontos de valor em cada solicitação PUT. Se desejar atualizar apenas os pontos de valor de um item específico, preservando os pontos de valor de outros itens, recupere o conjunto atual de pontos de valor usando uma solicitação GET, modifique os pontos de valor do item desejado e envie o conjunto modificado de pontos de valor de volta com os pontos de valor atualizados para o item específico. ### Obter lista de cadeias de recompensas - [GET /v3/project/{project_id}/admin/reward_chain](https://developers.xsolla.com/pt/api/liveops/reward-chain-value-points-admin/admin-get-reward-chains.md): Obtém lista de cadeias de recompensa. AtençãoTodos os projetos têm a limitação do número de itens que você pode obter na resposta. O valor padrão e máximo é de 10 itens por resposta. Para obter mais dados página por página, use os campos limit e offset. ### Criar cadeia de recompensas - [POST /v3/project/{project_id}/admin/reward_chain](https://developers.xsolla.com/pt/api/liveops/reward-chain-value-points-admin/admin-create-reward-chain.md): Cria cadeias de recompensas. ### Excluir cadeia de recompensas - [DELETE /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/pt/api/liveops/reward-chain-value-points-admin/admin-delete-reward-chain.md): Exclui uma cadeia de recompensas específica. ### Obtenha a cadeia de recompensas - [GET /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/pt/api/liveops/reward-chain-value-points-admin/admin-get-reward-chain.md): Obtém uma cadeia de recompensa específica. ### Atualizar cadeia de recompensas - [PUT /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/pt/api/liveops/reward-chain-value-points-admin/admin-update-reward-chain.md): Atualiza a cadeia de recompensas específica. ### Redefinir cadeia de recompensas - [POST /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/reset](https://developers.xsolla.com/pt/api/liveops/reward-chain-value-points-admin/admin-reset-reward-chain.md): Redefine os pontos de valor e o progresso de todos os usuários na cadeia de recompensa. Após a redefinição, você pode atualizar o período de validade da cadeia de recompensas e o usuário poderá progredir nela novamente. Aviso Você não deve redefinir a cadeia de recompensas durante seu período de validade. Nesse caso, os usuários podem perder pontos de valor ganhos antes de reivindicar sua recompensa. ### Alternar cadeia de recompensas - [PUT /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/toggle](https://developers.xsolla.com/pt/api/liveops/reward-chain-value-points-admin/admin-toggle-reward-chain.md): Ativar/desativar a cadeia de recompensas. ## Cliente ### Obtenha as cadeias de recompensa do usuário atual - [GET /v2/project/{project_id}/user/reward_chain](https://developers.xsolla.com/pt/api/liveops/reward-chain-client/get-reward-chains-list.md): Ponto de extremidade do cliente. Obtém as cadeias de recompensa do usuário atual. AtençãoTodos os projetos têm a limitação do número de itens que você pode obter na resposta. O valor padrão e máximo é de 50 itens por resposta. Para obter mais dados página por página, use os campos limit e offset. ### Obter o saldo de pontos de valor do usuário atual - [GET /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/balance](https://developers.xsolla.com/pt/api/liveops/reward-chain-client/get-user-reward-chain-balance.md): Ponto de extremidade do cliente. Obtém o saldo de pontos de valor do usuário atual. ### Resgatar recompensa por etapa - [POST /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/step/{step_id}/claim](https://developers.xsolla.com/pt/api/liveops/reward-chain-client/claim-user-reward-chain-step-reward.md): Ponto de extremidade do cliente. Reivindica a recompensa de passo do usuário atual de uma cadeia de recompensas. ## Cliente de clãs ### Obter os 10 maiores contribuintes da cadeia de recompensas no clã - [GET /v2/project/{project_id}/user/clan/contributors/{reward_chain_id}/top](https://developers.xsolla.com/pt/api/liveops/clan-reward-chain-client/get-user-clan-top-contributors.md): Recupera a lista dos 10 maiores contribuidores para a cadeia de recompensas específica no clã do usuário atual. Se um usuário não pertence a um clã, a chamada retornará uma matriz vazia. ### Atualizar o clã do usuário atual - [PUT /v2/project/{project_id}/user/clan/update](https://developers.xsolla.com/pt/api/liveops/clan-reward-chain-client/user-clan-update.md): Atualiza o clã de um usuário atual por meio de atributos de usuário. Resgata todas as recompensas de cadeias de recompensas que não foram resgatadas de um clã anterior e as retorna na resposta. Se o usuário estava em um clã e agora não está mais, sua inclusão no clã será revogada. Se o usuário mudou de clã, o clã será alterado. ## Admin ### Obter lista de recompensas diárias - [GET /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/pt/api/liveops/daily-chain-admin/admin-get-daily-chains.md): Obtém uma lista de recompensas diárias para administração. AvisoUm método retorna uma lista paginada de itens. O valor máximo e padrão é de 50 itens por resposta. Para obter mais itens da lista, use os parâmetros limit e offset, e busque mais páginas. Por exemplo, ao chamar um método com 'limit = 25' e 'offset = 100', a resposta retorna 25 itens a partir do 101º item na lista geral. ### Criar recompensa diária - [POST /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/pt/api/liveops/daily-chain-admin/admin-create-daily-chain.md): Cria uma recompensa diária. ### Excluir recompensa diária - [DELETE /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/pt/api/liveops/daily-chain-admin/admin-delete-daily-chain.md): Exclui uma recompensa diária específica. ### Obter recompensa diária - [GET /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/pt/api/liveops/daily-chain-admin/admin-get-daily-chain.md): Obtém uma cadeia de recompensas específica para administração. ### Atualizar recompensa diária - [PUT /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/pt/api/liveops/daily-chain-admin/admin-update-daily-chain.md): Atualiza uma recompensa diária específica. ### Redefinir recompensa diária - [POST /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}/reset](https://developers.xsolla.com/pt/api/liveops/daily-chain-admin/admin-reset-daily-chain.md): Redefine o progresso para todos os usuários na recompensa diária. Aplica-se apenas a recompensas diárias do tipo rolling. ### Alternar recompensa diária - [PUT /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}/toggle](https://developers.xsolla.com/pt/api/liveops/daily-chain-admin/admin-toggle-daily-chain.md): Ativa ou desativa uma recompensa diária. ## Cliente ### Obter recompensas diárias do usuário atual - [GET /v2/project/{project_id}/user/daily_chain](https://developers.xsolla.com/pt/api/liveops/daily-chain-client/get-daily-chains-list.md): Ponto de extremidade do cliente. Obtém as recompensas diárias do usuário atual. AvisoUm método retorna uma lista paginada de itens. O valor máximo e padrão é de 50 itens por resposta. Para obter mais itens da lista, use os parâmetros limit e offset, e busque mais páginas. Por exemplo, ao chamar um método com 'limit = 25' e 'offset = 100', a resposta retorna 25 itens a partir do 101º item na lista geral. ### Obtém a recompensa diária do usuário atual por seu ID - [GET /v2/project/{project_id}/user/daily_chain/{daily_chain_id}](https://developers.xsolla.com/pt/api/liveops/daily-chain-client/get-user-daily-chain-by-id.md): Ponto de extremidade do cliente. Obtém a recompensa diária do usuário atual por seu ID. ### Resgatar etapa da recompensa diária - [POST /v2/project/{project_id}/user/daily_chain/{daily_chain_id}/step/number/{step_number}/claim](https://developers.xsolla.com/pt/api/liveops/daily-chain-client/claim-user-daily-chain-step-reward.md): Ponto de extremidade do cliente. Resgata a recompensa de etapa do usuário atual a partir de uma recompensa diária. Todas as etapas só podem ser resgatadas em ordem sequencial. A recompensa de uma etapa perdida não pode ser obtida com moedas virtuais ou reais, nem assistindo a um anúncio. ## Admin ### Obter lista de cadeias de ofertas - [GET /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/pt/api/liveops/offer-chain-admin/admin-get-offer-chains.md): Obtém a lista de cadeias de ofertas para administração. AvisoTodos os projetos têm um limite no número de itens que podem ser retornados em uma única resposta. O valor padrão e máximo é de 10 itens por resposta. Para obter mais dados, use os parâmetros de consulta limit e offset para a paginação. ### Criar cadeia de ofertas - [POST /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/pt/api/liveops/offer-chain-admin/admin-create-offer-chain.md): Cria uma cadeia de ofertas. ### Excluir cadeia de ofertas - [DELETE /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/pt/api/liveops/offer-chain-admin/admin-delete-offer-chain.md): Exclui uma cadeia de ofertas específica. Após a exclusão:Todas as recompensas já recebidas pelos usuários são retidas.Etapas não concluídas ficam indisponíveis e suas recompensas não podem mais ser obtidas. Ao contrário de desabilitar a cadeia de ofertas por meio da chamada da chamada Alternar cadeia de ofertas, a exclusão é irreversível e o progresso do usuário não é preservado. ### Obter cadeia de ofertas - [GET /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/pt/api/liveops/offer-chain-admin/admin-get-offer-chain.md): Obtém uma cadeia de ofertas específica para administração. ### Atualizar cadeia de ofertas - [PUT /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/pt/api/liveops/offer-chain-admin/admin-update-offer-chain.md): Atualiza uma cadeia de ofertas específica. ### Alternar cadeia de ofertas - [PUT /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}/toggle](https://developers.xsolla.com/pt/api/liveops/offer-chain-admin/admin-toggle-offer-chain.md): Habilita ou desabilita uma cadeia de ofertas. Quando a cadeia de ofertas é desativada, os usuários perdem temporariamente o acesso a ela, mas seu progresso é preservado. Depois que a cadeia de ofertas for reativada, os usuários poderão continuar da etapa de onde pararam. ## Cliente ### Obtenha as cadeias de ofertas do usuário atual - [GET /v2/project/{project_id}/user/offer_chain](https://developers.xsolla.com/pt/api/liveops/offer-chain-client/get-offer-chains-list.md): Obtém as cadeias de ofertas atuais do usuário. AvisoTodos os projetos têm um limite no número de itens que podem ser retornados em uma única resposta. O valor padrão e máximo é de 30 itens por resposta. Para obter mais dados, use os parâmetros de consulta limit e offset para a paginação. ### Obter a cadeia de ofertas do usuário atual por ID - [GET /v2/project/{project_id}/user/offer_chain/{offer_chain_id}](https://developers.xsolla.com/pt/api/liveops/offer-chain-client/get-user-offer-chain-by-id.md): Obtém a cadeia de ofertas do usuário atual pela ID da cadeia de ofertas. ### Resgate a etapa da cadeia de oferta gratuita - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/claim](https://developers.xsolla.com/pt/api/liveops/offer-chain-client/claim-user-offer-chain-step-reward.md): Conclui a progressão do usuário atual por meio da etapa da cadeia de ofertas e concede a recompensa associada. Aviso Use essa chamada somente para etapas gratuitas na cadeia de ofertas. Para etapas que exigem pagamento em moeda real, use a chamada Criar ordem para a etapa da cadeia de ofertas pagas. ### Criar ordem para a etapa da cadeia de ofertas pagas - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/pt/api/liveops/offer-chain-client/order-user-offer-chain-step-reward.md): Cria um pedido para o item associado à etapa da cadeia de ofertas pagas especificada. O pedido criado obtém o status new do pedido. Para abrir a interface do usuário de pagamento em uma nova janela, use o seguinte link: https://secure.xsolla.com/paystation4/?token={token}, onde {token} é o token recebido. Para fins de teste, use este URL: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Aviso Esse método deve ser usado no lado do cliente. O endereço IP do usuário é usado para determinar o país, o que afeta a moeda e os métodos de pagamento disponíveis. Usar esse método do lado do servidor pode resultar na detecção incorreta da moeda e afetar os métodos de pagamento no Pay Station. Aviso Use essa chamada somente para etapas da cadeia de ofertas pagas. Para obter etapas gratuitas, use a chamada da cadeia de Resgate a etapa da cadeia de oferta gratuita. ## payment-client-side ### Criar ordem para a etapa da cadeia de ofertas pagas - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/pt/api/liveops/offer-chain-client/order-user-offer-chain-step-reward.md): Cria um pedido para o item associado à etapa da cadeia de ofertas pagas especificada. O pedido criado obtém o status new do pedido. Para abrir a interface do usuário de pagamento em uma nova janela, use o seguinte link: https://secure.xsolla.com/paystation4/?token={token}, onde {token} é o token recebido. Para fins de teste, use este URL: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Aviso Esse método deve ser usado no lado do cliente. O endereço IP do usuário é usado para determinar o país, o que afeta a moeda e os métodos de pagamento disponíveis. Usar esse método do lado do servidor pode resultar na detecção incorreta da moeda e afetar os métodos de pagamento no Pay Station. Aviso Use essa chamada somente para etapas da cadeia de ofertas pagas. Para obter etapas gratuitas, use a chamada da cadeia de Resgate a etapa da cadeia de oferta gratuita. ## Admin ### Obter informações sobre venda cruzada no projeto - [GET /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/pt/api/liveops/upsell-admin/get-upsell-configurations-for-project-admin.md): Recupera as informações sobre a venda cruzada no projeto: se está habilitado, o tipo de venda cruzada e a lista de SKUs de itens que fazem parte dessa venda cruzada. ### Criar venda cruzada - [POST /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/pt/api/liveops/upsell-admin/post-upsell.md): Cria uma venda cruzada para um projeto. ### Atualizar venda cruzada - [PUT /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/pt/api/liveops/upsell-admin/put-upsell.md): Atualize uma venda cruzada para um projeto. ### Ativar/desativar a venda cruzada do projeto - [PUT /v2/project/{project_id}/admin/items/upsell/{toggle}](https://developers.xsolla.com/pt/api/liveops/upsell-admin/put-upsell-toggle-active-inactive.md): Altera o status de uma venda cruzada em um projeto para ativo ou inativo. ## Cliente ### Obter lista de itens de venda cruzada no projeto - [GET /v2/project/{project_id}/items/upsell](https://developers.xsolla.com/pt/api/liveops/upsell-client/get-upsell-for-project-client.md): Obtém uma lista de itens de venda cruzada em um projeto se eles já tiverem sido configurados.