# API Shop Builder # 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 Shop Builder API provides a third-party solution for implementing the server side for your store interface. Use the endpoints to manage in-game items, in-game currencies, cart, player inventory, promotions, game library, etc. 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 [API Shop Builder](https://developers.xsolla.com/_bundle/@l10n/pt/api/shop-builder/index.yaml) ## Admin ### Obter lista de atributos (admin) - [GET /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/pt/api/shop-builder/attribute-admin/admin-get-attribute-list.md): Obtém a lista de atributos de um projeto para administração. ### Criar atributo - [POST /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/pt/api/shop-builder/attribute-admin/admin-create-attribute.md): Cria um atributo. ### Excluir atributo - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/pt/api/shop-builder/attribute-admin/delete-attribute.md): Exclui um atributo. AvisoSe você excluir um atributo de item, todos os seus dados e conexões com itens serão perdidos. ### Obter atributo especificado - [GET /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/pt/api/shop-builder/attribute-admin/admin-get-attribute.md): Obtém um atributo especificado. ### Atualizar atributo - [PUT /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/pt/api/shop-builder/attribute-admin/admin-update-attribute.md): Atualiza um atributo. ### Excluir todos os valores do atributo - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/pt/api/shop-builder/attribute-admin/admin-delete-all-attribute-value.md): Exclui todos os valores do atributo. AvisoSe você excluir o valor de um atributo, todas as conexões entre o atributo e os itens serão perdidas. Para alterar o valor do atributo de um item, use a chamada de API Atualizar valor do atributo em vez de excluir o valor e criar um novo. ### Criar valor de atributo - [POST /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/pt/api/shop-builder/attribute-admin/admin-create-attribute-value.md): Cria um valor de atributo. AtençãoTodos os projetos têm a limitação do número de valores de atributo. O valor padrão e máximo é de 20 valores por atributo. ### Excluir valor de atributo - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/pt/api/shop-builder/attribute-admin/admin-delete-attribute-value.md): Exclui um valor de atributo. AvisoSe você excluir o valor de um atributo, todas as conexões entre o atributo e os itens serão perdidas. Para alterar o valor do atributo de um item, use a chamada de API Atualizar valor do atributo em vez de excluir o valor e criar um novo. ### Atualizar valor do atributo - [PUT /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/pt/api/shop-builder/attribute-admin/admin-update-attribute-value.md): Atualiza os valores de um atributo. ## 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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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). ## Admin ### Obter lista de pacotes - [GET /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/pt/api/shop-builder/bundles-admin/admin-get-bundle-list.md): Obtém a lista de pacotes dentro de um projeto para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de armazenamento. ### Criar conjunto - [POST /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/pt/api/shop-builder/bundles-admin/admin-create-bundle.md): Cria um conjunto. ### Obter lista de conjuntos por ID de grupo externo especificado - [GET /v2/project/{project_id}/admin/items/bundle/group/external_id/{external_id}](https://developers.xsolla.com/pt/api/shop-builder/bundles-admin/admin-get-bundle-list-in-group-by-external-id.md): Obtém a lista de conjuntos dentro de um grupo para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Obter lista de conjuntos por ID de grupo especificado - [GET /v2/project/{project_id}/admin/items/bundle/group/id/{group_id}](https://developers.xsolla.com/pt/api/shop-builder/bundles-admin/admin-get-bundle-list-in-group-by-id.md): Obtém a lista de conjuntos dentro de um grupo para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Excluir conjunto - [DELETE /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/pt/api/shop-builder/bundles-admin/admin-delete-bundle.md): Exclui um conjunto. ### Obter conjunto - [GET /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/pt/api/shop-builder/bundles-admin/admin-get-bundle.md): Obtém o conjunto dentro de um projeto para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Conjunto de atualização - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/pt/api/shop-builder/bundles-admin/admin-update-bundle.md): Atualiza um conjunto. ### Ocultar conjunto no catálogo - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/hide](https://developers.xsolla.com/pt/api/shop-builder/bundles-admin/admin-hide-bundle.md): Oculta um conjunto em um catálogo. ### Mostrar conjunto no catálogo - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/show](https://developers.xsolla.com/pt/api/shop-builder/bundles-admin/admin-show-bundle.md): Mostra um conjunto em um catálogo. ## Catálogo ### Obter lista de pacotes - [GET /v2/project/{project_id}/items/bundle](https://developers.xsolla.com/pt/api/shop-builder/bundles-catalog/get-bundle-list.md): Recebe uma lista de conjuntos para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber na resposta. O valor padrão e máximo é de 50 itens por resposta. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### Obter lista de pacotes por grupo especificado - [GET /v2/project/{project_id}/items/bundle/group/{external_id}](https://developers.xsolla.com/pt/api/shop-builder/bundles-catalog/get-bundle-list-in-group.md): Recebe uma lista de conjuntos dentro de um grupo para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber na resposta. O valor padrão e máximo é de 50 itens por resposta. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### Obter pacote especificado - [GET /v2/project/{project_id}/items/bundle/sku/{sku}](https://developers.xsolla.com/pt/api/shop-builder/bundles-catalog/get-bundle.md): Obtém um conjunto especificado. ObservaçãoEsse ponto de extremidade, acessível sem autorização, retorna dados genéricos. No entanto, a autorização enriquece a resposta com detalhes específicos do usuário para um resultado personalizado, como limites de usuários disponíveis e promoções. ## Carrinho (lado do cliente) ### Obter o carrinho do usuário atual - [GET /v2/project/{project_id}/cart](https://developers.xsolla.com/pt/api/shop-builder/cart-client-side/get-user-cart.md): Retorna o carrinho do usuário atual. ### Excluir todos os itens do carrinho atual - [PUT /v2/project/{project_id}/cart/clear](https://developers.xsolla.com/pt/api/shop-builder/cart-client-side/cart-clear.md): Exclui todos os itens do carrinho. ### Preencher o carrinho com itens - [PUT /v2/project/{project_id}/cart/fill](https://developers.xsolla.com/pt/api/shop-builder/cart-client-side/cart-fill.md): Preenche o carrinho de itens. Se o carrinho já tiver um item com o mesmo SKU, o item existente será substituído pelo valor passado. ### Excluir item do carrinho atual - [DELETE /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/cart-client-side/delete-item.md): Remove um item do carrinho. ### Atualizar item do carrinho do carrinho atual - [PUT /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/cart-client-side/put-item.md): Atualiza um item de carrinho existente ou cria o item no carrinho. ### Obter carrinho por ID de carrinho - [GET /v2/project/{project_id}/cart/{cart_id}](https://developers.xsolla.com/pt/api/shop-builder/cart-client-side/get-cart-by-id.md): Devolve o carrinho do utilizador pelo ID de carrinho. ### Excluir todos os itens do carrinho pelo ID de carrinho - [PUT /v2/project/{project_id}/cart/{cart_id}/clear](https://developers.xsolla.com/pt/api/shop-builder/cart-client-side/cart-clear-by-id.md): Exclui todos os itens do carrinho. ### Preencha o carrinho específico com itens - [PUT /v2/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/pt/api/shop-builder/cart-client-side/cart-fill-by-id.md): Preenche o carrinho específico com itens. Se o carrinho já tiver um item com o mesmo SKU, a posição do item existente será substituída pelo valor passado. ### Excluir item de carrinho por ID de carrinho - [DELETE /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/cart-client-side/delete-item-by-cart-id.md): Remove um item do carrinho. ### Atualizar item do carrinho por ID de carrinho - [PUT /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/cart-client-side/put-item-by-cart-id.md): Atualiza um item de carrinho existente ou cria o item no carrinho. ## Carrinho (lado do servidor) ### Preencher o carrinho com itens - [PUT /v2/admin/project/{project_id}/cart/fill](https://developers.xsolla.com/pt/api/shop-builder/cart-server-side/admin-cart-fill.md): Preenche o carrinho atual com itens. Se o carrinho já tiver um item com o mesmo SKU, o item existente será substituído pelo valor passado. ### Preencha o ID do carrinho pelo carrinho com itens - [PUT /v2/admin/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/pt/api/shop-builder/cart-server-side/admin-fill-cart-by-id.md): Preenche o carrinho por ID de carrinho com itens. Se o carrinho já tiver um item com o mesmo SKU, o item existente será substituído pelo valor passado. ## Pagamento (lado do cliente) ### Criar pedido com todos os itens do carrinho atual - [POST /v2/project/{project_id}/payment/cart](https://developers.xsolla.com/pt/api/shop-builder/payment-client-side/create-order.md): Usado para a integração cliente-servidor. Cria um pedido com todos os itens do carrinho e gera um token de pagamento para ele. O pedido criado obtém o status do pedido new. O IP do cliente é usado para determinar o país do usuário, que é usado para aplicar a moeda correspondente e os métodos de pagamento disponíveis para o pedido. Para abrir a interface 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 Como esse método usa o IP para determinar o país do usuário e selecionar uma moeda para o pedido, é importante usar esse método apenas do lado do cliente e não do lado do servidor. Usar esse método do lado do servidor pode causar determinação incorreta da moeda e afetar os métodos de pagamento no Pay Station. ### Criar pedido com todos os itens de um carrinho específico - [POST /v2/project/{project_id}/payment/cart/{cart_id}](https://developers.xsolla.com/pt/api/shop-builder/payment-client-side/create-order-by-cart-id.md): Usado para a integração cliente-servidor. Cria um pedido com todos os itens do carrinho em particular e gera um token de pagamento para ele. O pedido criado obtém o status do pedido new. O IP do cliente é usado para determinar o país do usuário, que é usado para aplicar a moeda correspondente e os métodos de pagamento disponíveis para o pedido. Para abrir a interface 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 Como esse método usa o IP para determinar o país do usuário e selecionar uma moeda para o pedido, é importante usar esse método apenas do lado do cliente e não do lado do servidor. Usar esse método do lado do servidor pode causar determinação incorreta da moeda e afetar os métodos de pagamento no Pay Station. ### Criar pedido com item especificado - [POST /v2/project/{project_id}/payment/item/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/payment-client-side/create-order-with-item.md): Usado para a integração cliente-servidor. Cria um pedido com um item especificado e gera um token de pagamento para ele. O pedido criado obtém o status do pedido new. O IP do cliente é usado para determinar o país do usuário, que é usado para aplicar a moeda correspondente e os métodos de pagamento disponíveis para o pedido. Para abrir a interface 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 Como esse método usa o IP para determinar o país do usuário e selecionar uma moeda para o pedido, é importante usar esse método apenas do lado do cliente e não do lado do servidor. Usar esse método do lado do servidor pode causar determinação incorreta da moeda e afetar os métodos de pagamento no Pay Station. ### 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/shop-builder/payment-client-side/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. ### 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/shop-builder/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. ## Cliente ### 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/shop-builder/payment-client-side/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. ### Obtenha as cadeias de ofertas do usuário atual - [GET /v2/project/{project_id}/user/offer_chain](https://developers.xsolla.com/pt/api/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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. ## Pagamento (lado do servidor) ### Criar token de pagamento para compra - [POST /v3/project/{project_id}/admin/payment/token](https://developers.xsolla.com/pt/api/shop-builder/payment-server-side/admin-create-payment-token.md): Gera um pedido e um token de pagamento para ele. O pedido é gerado com base nos itens passados no corpo da solicitação. Para abrir a interface de pagamento em uma nova janela, use o seguinte link: https://secure.xsolla.com/paystation4/?token={token}, onde {token} é o token recebido. Para propósitos de teste, use este URL: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Aviso O parâmetro user.country.value é usado para selecionar uma moeda para o pedido. Se o país do usuário é desconhecido, fornecer o IP do usuário no cabeçalho X-User-Ip é uma opção alternativa. Uma dessas duas opções é necessária para o trabalho correto desse método. A moeda selecionada é usada para métodos de pagamento no Pay Station. ## Pedido ### Obter pedido - [GET /v2/project/{project_id}/order/{order_id}](https://developers.xsolla.com/pt/api/shop-builder/order/get-order.md): Recupera uma ordem especificada. ### Obter lista de pedidos para o período especificado - [POST /v3/project/{project_id}/admin/order/search](https://developers.xsolla.com/pt/api/shop-builder/order/admin-order-search.md): Recupera a lista de pedidos, organizada da data de criação mais antiga para a mais recente. ## Itens gratuitos ### Criar pedido com carrinho grátis - [POST /v2/project/{project_id}/free/cart](https://developers.xsolla.com/pt/api/shop-builder/free-item/create-free-order.md): Cria um pedido com todos os itens do carrinho gratuito. O pedido criado receberá um status de pedido done. ### Criar pedido com carrinho gratuito específico - [POST /v2/project/{project_id}/free/cart/{cart_id}](https://developers.xsolla.com/pt/api/shop-builder/free-item/create-free-order-by-cart-id.md): Cria um pedido com todos os itens do carrinho gratuito específico. O pedido criado receberá um status de pedido done. ### Criar pedido com item gratuito especificado - [POST /v2/project/{project_id}/free/item/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/free-item/create-free-order-with-item.md): Cria um pedido com um item livre especificado. O pedido criado receberá um status de pedido done. ## Webhooks ### Obter informações sobre as configurações do webhook - [GET /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/pt/api/shop-builder/common-webhooks/get-webhook.md): Obtém as informações sobre as configurações de webhook na Store. Consulte a documentação de webhooks para saber mais. ### Atualizar informações sobre as configurações do webhook - [PUT /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/pt/api/shop-builder/common-webhooks/update-webhook.md): Atualiza as informações sobre as configurações de webhook na Store. Consulte a documentação de webhooks para saber mais. ## Reservas ### Remover a quantidade de limite de pré-venda do item - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/common-pre-orders/remove-pre-order-limit.md): Remova a quantidade do limite de pré-venda do item. A API Pre-Order limit permite que você venda um item em uma quantidade limitada. Para configurar a pré-venda em si, vá para a seção Admin do módulo do item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos Aliases para este ponto de extremidade: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Obter informações sobre o limite de pré-venda de itens - [GET /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/common-pre-orders/get-pre-order-limit.md): Obtenha o limite de pré-venda do item. A API Pre-Order limit permite que você venda um item em uma quantidade limitada. Para configurar a pré-venda em si, vá para a seção Admin do módulo do item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos Aliases para este ponto de extremidade: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Adicionar quantidade ao limite de pré-venda do item - [POST /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/common-pre-orders/add-pre-order-limit.md): Adicione a quantidade ao limite de pré-venda do item. A API Pre-Order limit permite que você venda um item em uma quantidade limitada. Para configurar a pré-venda em si, vá para a seção Admin do módulo do item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos Aliases para este ponto de extremidade: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Definir o limite de pré-venda da quantidade de item - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/common-pre-orders/set-pre-order-limit.md): Defina a quantidade do limite de pré-venda do item. A API Pre-Order limit permite que você venda um item em uma quantidade limitada. Para configurar a pré-venda em si, vá para a seção Admin do módulo do item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos Aliases para este ponto de extremidade: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Remover toda a quantidade de limite de pré-venda do item - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/pt/api/shop-builder/common-pre-orders/remove-all-pre-order-limit.md): Remova o limite de pré-venda do item. A API Pre-Order limit permite que você venda um item em uma quantidade limitada. Para configurar a pré-venda em si, vá para a seção admin do módulo do item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos Aliases para este ponto de extremidade: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/all ### Alternar o limite de pré-venda do item - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/toggle](https://developers.xsolla.com/pt/api/shop-builder/common-pre-orders/toggle-pre-order-limit.md): Ative/desative o limite de pré-venda do item. A API Pre-Order limit permite que você venda um item em uma quantidade limitada. Para configurar a pré-venda em si, vá para a seção admin do módulo do item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos Aliases para este ponto de extremidade: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/toggle ## Comerciante ### Obter projetos - [GET /v2/merchant/{merchant_id}/projects](https://developers.xsolla.com/pt/api/shop-builder/common-merchant/get-projects.md): Obtém a lista de projetos do comerciante. AvisoEssa chamada de API não contém o trajeto de parâmetro project_id, portanto, você precisa usar a chave API que é válida em todos os projetos da empresa para configurar a autorização. ## Catálogo Esta API permite obter qualquer tipo de itens vendáveis ou itens específicos. ### Obter lista de itens vendáveis - [GET /v2/project/{project_id}/items](https://developers.xsolla.com/pt/api/shop-builder/common-catalog/get-sellable-items.md): Recebe uma lista de itens vendáveis para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber 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. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### Obter lista de itens vendáveis por grupo especificado - [GET /v2/project/{project_id}/items/group/{external_id}](https://developers.xsolla.com/pt/api/shop-builder/common-catalog/get-sellable-items-group.md): Recebe uma lista de itens vendáveis do grupo especificado para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber 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. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### Obter item vendável por ID - [GET /v2/project/{project_id}/items/id/{item_id}](https://developers.xsolla.com/pt/api/shop-builder/common-catalog/get-sellable-item-by-id.md): Obtém um item comercializável por seu ID. ObservaçãoEsse ponto de extremidade, acessível sem autorização, retorna dados genéricos. No entanto, a autorização enriquece a resposta com detalhes específicos do usuário para um resultado personalizado, como limites de usuários disponíveis e promoções. ### Obter item vendável por SKU - [GET /v2/project/{project_id}/items/sku/{sku}](https://developers.xsolla.com/pt/api/shop-builder/common-catalog/get-sellable-item-by-sku.md): Obtém um item vendável por SKU para criar um catálogo. ObservaçãoEsse ponto de extremidade, acessível sem autorização, retorna dados genéricos. No entanto, a autorização enriquece a resposta com detalhes específicos do usuário para um resultado personalizado, como limites de usuários disponíveis e promoções. ## Regiões comuns ### Obter lista de regiões - [GET /v2/project/{project_id}/admin/region](https://developers.xsolla.com/pt/api/shop-builder/common-regions/admin-get-regions.md): Obtém lista de regiões. Você pode usar uma região para gerenciar suas restrições regionais. ### Criar região - [POST /v2/project/{project_id}/admin/region](https://developers.xsolla.com/pt/api/shop-builder/common-regions/admin-create-region.md): Cria região. Você pode usar uma região para gerenciar suas restrições regionais. ### Excluir região - [DELETE /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/pt/api/shop-builder/common-regions/admin-delete-region.md): Exclui uma região específica. ### Obter região - [GET /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/pt/api/shop-builder/common-regions/admin-get-region.md): Obtém região específica. Você pode usar uma região para gerenciar suas restrições regionais. ### Atualizar região - [PUT /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/pt/api/shop-builder/common-regions/admin-update-region.md): Atualiza uma região específica. Você pode usar uma região para gerenciar suas restrições regionais. ## Catálogo ### Obter lista de jogos - [GET /v2/project/{project_id}/items/game](https://developers.xsolla.com/pt/api/shop-builder/game-keys-catalog/get-games-list.md): Recebe uma lista de jogos para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber 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. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### Obter lista de DRM - [GET /v2/project/{project_id}/items/game/drm](https://developers.xsolla.com/pt/api/shop-builder/game-keys-catalog/get-drm-list.md): Obtém a lista de DRMs disponíveis. ### Obter lista de jogos por grupo especificado - [GET /v2/project/{project_id}/items/game/group/{external_id}](https://developers.xsolla.com/pt/api/shop-builder/game-keys-catalog/get-games-group.md): Recebe uma lista de jogos do grupo especificado para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber 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. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### Obter lista de chaves de jogo por grupo especificado - [GET /v2/project/{project_id}/items/game/key/group/{external_id}](https://developers.xsolla.com/pt/api/shop-builder/game-keys-catalog/get-game-keys-group.md): Recebe uma lista de chaves de jogo do grupo especificado para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber 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. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### Obter chave de jogo para catálogo - [GET /v2/project/{project_id}/items/game/key/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/game-keys-catalog/get-game-key-by-sku.md): Obtém uma chave de jogo para o catálogo. ObservaçãoEsse ponto de extremidade, acessível sem autorização, retorna dados genéricos. No entanto, a autorização enriquece a resposta com detalhes específicos do usuário para um resultado personalizado, como limites de usuários disponíveis e promoções. ### Obter jogo para catálogo - [GET /v2/project/{project_id}/items/game/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/game-keys-catalog/get-game-by-sku.md): Obtém um jogo para o catálogo. ObservaçãoEsse ponto de extremidade, acessível sem autorização, retorna dados genéricos. No entanto, a autorização enriquece a resposta com detalhes específicos do usuário para um resultado personalizado, como limites de usuários disponíveis e promoções. ## Direito ### Direito à concessão (admin) - [POST /v2/project/{project_id}/admin/entitlement/grant](https://developers.xsolla.com/pt/api/shop-builder/game-keys-entitlement/grant-entitlement-admin.md): Concede direito ao usuário. AtençãoCódigos de jogos ou jogos para plataformas sem DRM podem ser apenas concedidos. ### Revogar direito (admin) - [POST /v2/project/{project_id}/admin/entitlement/revoke](https://developers.xsolla.com/pt/api/shop-builder/game-keys-entitlement/revoke-entitlement-admin.md): Revoga o direito do usuário. AtençãoCódigos de jogos ou jogos para plataformas sem DRM podem ser apenas revogados. ### Obter lista de jogos de propriedade do usuário - [GET /v2/project/{project_id}/entitlement](https://developers.xsolla.com/pt/api/shop-builder/game-keys-entitlement/get-user-games.md): Obtenha a lista de jogos de propriedade do usuário. A resposta conterá uma matriz de jogos de propriedade de um usuário específico. AtençãoTodos os projetos têm uma 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. ### Resgatar código de jogo por cliente - [POST /v2/project/{project_id}/entitlement/redeem](https://developers.xsolla.com/pt/api/shop-builder/game-keys-entitlement/redeem-game-pin-code.md): Concede o direito por um código de jogo fornecido. AtençãoVocê pode resgatar códigos apenas para a plataforma sem DRM. ## Admin ### Obter lista de jogos (admin) - [GET /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/pt/api/shop-builder/game-keys-admin/admin-get-game-list.md): Obtém a lista de jogos dentro de um projeto para administração. O jogo consiste em chaves de jogo que podem ser compradas por um usuário. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de armazenamento. ### Criar jogo - [POST /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/pt/api/shop-builder/game-keys-admin/admin-create-game.md): Cria um jogo no projeto. ### Excluir jogo por ID - [DELETE /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/pt/api/shop-builder/game-keys-admin/admin-delete-game-by-id.md): Exclui um jogo no projeto por ID. ### Obter jogo por ID (admin) - [GET /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/pt/api/shop-builder/game-keys-admin/admin-get-game-by-id.md): Recebe um jogo para administração. O jogo consiste em chaves de jogo que podem ser compradas por um usuário. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de armazenamento. ### Atualizar jogo por ID - [PUT /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/pt/api/shop-builder/game-keys-admin/admin-update-game-by-id.md): Atualiza um jogo no projeto por ID. ### Excluir códigos por ID - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/id/{item_id}](https://developers.xsolla.com/pt/api/shop-builder/game-keys-admin/admin-delete-codes-by-id.md): Exclui todos os códigos por ID de chave de jogo. ### Excluir códigos - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/game-keys-admin/admin-delete-codes-by-sku.md): Exclui todos os códigos por SKU de chave de jogo. ### Obter códigos por ID - [GET /v2/project/{project_id}/admin/items/game/key/request/id/{item_id}](https://developers.xsolla.com/pt/api/shop-builder/game-keys-admin/admin-get-codes-by-id.md): Obtém um certo número de códigos por ID de chave de jogo. ### Obter códigos - [GET /v2/project/{project_id}/admin/items/game/key/request/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/game-keys-admin/admin-get-codes-by-sku.md): Obtém um certo número de códigos por SKU de chave de jogo. ### Carregar códigos por ID - [POST /v2/project/{project_id}/admin/items/game/key/upload/id/{item_id}](https://developers.xsolla.com/pt/api/shop-builder/game-keys-admin/admin-upload-codes-by-id.md): Carrega códigos por ID de chave de jogo. ### Obter códigos carregando informações da sessão - [GET /v2/project/{project_id}/admin/items/game/key/upload/session/{session_id}](https://developers.xsolla.com/pt/api/shop-builder/game-keys-admin/admin-get-codes-session.md): Obtém códigos carregando informações de sessão. ### Carregar códigos - [POST /v2/project/{project_id}/admin/items/game/key/upload/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/game-keys-admin/admin-upload-codes-by-sku.md): Carrega códigos por SKU de chave de jogo. ### Excluir jogo por SKU - [DELETE /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/game-keys-admin/admin-delete-game-by-sku.md): Exclui um jogo no projeto por SKU. ### Obter jogo (admin) - [GET /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/game-keys-admin/admin-get-game-by-sku.md): Recebe um jogo para administração. O jogo consiste em chaves de jogo que podem ser compradas por um usuário. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de armazenamento. ### Atualizar jogo por SKU - [PUT /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/game-keys-admin/admin-update-game-by-sku.md): Atualiza um jogo no projeto por SKU. ## Comum ### Ativar promoção - [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/activate](https://developers.xsolla.com/pt/api/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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. ## Admin ### Obter lista de moedas virtuais - [GET /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currencies-list.md): Obtém a lista de moedas virtuais dentro de um projeto para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Criar moeda virtual - [POST /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-admin/admin-create-virtual-currency.md): Cria uma moeda virtual. ### Obter lista de pacotes de moedas virtuais (admin) - [GET /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currency-packages-list.md): Obtém a lista de pacotes de moedas virtuais dentro de um projeto para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Criar pacote de moedas virtuais - [POST /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-admin/admin-create-virtual-currency-package.md): Cria um pacote de moedas virtuais. ### Excluir pacote de moedas virtuais - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-admin/admin-delete-virtual-currency-package.md): Exclui um pacote de moedas virtuais. ### Obter pacote de moedas virtuais - [GET /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currency-package.md): Obtém o pacote de moedas virtuais dentro de um projeto para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Atualizar pacote de moedas virtuais - [PUT /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-admin/admin-update-virtual-currency-package.md): Atualiza um pacote de moedas virtuais. ### Excluir moeda virtual - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-admin/admin-delete-virtual-currency.md): Exclui uma moeda virtual. ### Obter moeda virtual - [GET /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currency.md): Obtém a moeda virtual dentro de um projeto para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Atualizar moeda virtual - [PUT /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-admin/admin-update-virtual-currency.md): Atualiza uma moeda virtual. ### Obter lista de itens virtuais - [GET /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-items-list.md): Obtém a lista de itens virtuais dentro de um projeto para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Criar item virtual - [POST /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-admin/admin-create-virtual-item.md): Cria um item virtual. ### Obter lista de itens virtuais por ID de grupo especificado externo - [GET /v2/project/{project_id}/admin/items/virtual_items/group/external_id/{external_id}](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-external-id.md): Obtém a lista de itens virtuais dentro de um grupo para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Obter lista de itens virtuais por ID de grupo especificado - [GET /v2/project/{project_id}/admin/items/virtual_items/group/id/{group_id}](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-id.md): Obtém a lista de itens virtuais dentro de um grupo para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Excluir item virtual - [DELETE /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-admin/admin-delete-virtual-item.md): Exclui um item virtual. ### Obter item virtual - [GET /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-item.md): Obtém o item virtual dentro de um projeto para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Atualizar item virtual - [PUT /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-admin/admin-update-virtual-item.md): Atualiza um item virtual. ## Catálogo ### Obter lista de grupo de itens - [GET /v2/project/{project_id}/items/groups](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-catalog/get-item-groups.md): Obtém uma lista de grupo de itens para criar um catálogo. ### Obter lista de moedas virtuais - [GET /v2/project/{project_id}/items/virtual_currency](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency.md): Recebe uma lista de moedas virtuais para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber 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. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### Obter lista de pacotes de moedas virtuais - [GET /v2/project/{project_id}/items/virtual_currency/package](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency-package.md): Recebe uma lista de pacotes de moedas virtuais para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber 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. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### Obter pacote de moedas virtuais por SKU - [GET /v2/project/{project_id}/items/virtual_currency/package/sku/{virtual_currency_package_sku}](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency-package-sku.md): Obtém pacotes de moedas virtuais por SKU para criar um catálogo. ObservaçãoEsse ponto de extremidade, acessível sem autorização, retorna dados genéricos. No entanto, a autorização enriquece a resposta com detalhes específicos do usuário para um resultado personalizado, como limites de usuários disponíveis e promoções. ### Obter moeda virtual por SKU - [GET /v2/project/{project_id}/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency-sku.md): Obtém uma moeda virtual por SKU para criar um catálogo. ObservaçãoEsse ponto de extremidade, acessível sem autorização, retorna dados genéricos. No entanto, a autorização enriquece a resposta com detalhes específicos do usuário para um resultado personalizado, como limites de usuários disponíveis e promoções. ### Obter lista de itens virtuais - [GET /v2/project/{project_id}/items/virtual_items](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-catalog/get-virtual-items.md): Recebe uma lista de itens virtuais para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber 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. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### Obter toda a lista de itens virtuais - [GET /v2/project/{project_id}/items/virtual_items/all](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-catalog/get-all-virtual-items.md): Obtém uma lista de todos os itens virtuais para pesquisar no lado do cliente. Atençãoretorna apenas o SKU, nome, grupos e descrição do item ObservaçãoO uso das chamadas API do catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho de Autorização. ### Obter lista de itens por grupo especificado - [GET /v2/project/{project_id}/items/virtual_items/group/{external_id}](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-catalog/get-virtual-items-group.md): Obtém uma lista de itens do grupo especificado para criar um catálogo. 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. ObservaçãoEsse ponto de extremidade, acessível sem autorização, retorna dados genéricos. No entanto, a autorização enriquece a resposta com detalhes específicos do usuário para um resultado personalizado, como limites de usuário disponíveis e promoções. ### Obter item virtual por SKU - [GET /v2/project/{project_id}/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/virtual-items-currency-catalog/get-virtual-items-sku.md): Obtém um item virtual por SKU para criar um catálogo. ObservaçãoEsse ponto de extremidade, acessível sem autorização, retorna dados genéricos. No entanto, a autorização enriquece a resposta com detalhes específicos do usuário para um resultado personalizado, como limites de usuários disponíveis e promoções. ## Pagamento virtual ### Criar pedido com item especificado comprado por moeda virtual - [POST /v2/project/{project_id}/payment/item/{item_sku}/virtual/{virtual_currency_sku}](https://developers.xsolla.com/pt/api/shop-builder/virtual-payment/create-order-with-item-for-virtual-currency.md): Cria compra de item usando moeda virtual. ## Gestão ### Atualizar todos os limites de compra para o usuário especificado - [DELETE /v2/project/{project_id}/admin/user/limit/item/all](https://developers.xsolla.com/pt/api/shop-builder/user-limits-admin/reset-all-user-items-limit.md): Atualiza todos os limites de compra em todos os itens para um usuário especificado para que ele possa comprar esses itens novamente. A API User limit permite que você venda um item em uma quantidade limitada. Para configurar os limites de compra, vá para a seção Admin do módulo de tipo de item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos ### Diminuir o número de itens disponíveis para o usuário especificado - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/user-limits-admin/remove-user-item-limit.md): Diminui o número restante de itens disponíveis para o usuário especificado dentro do limite aplicado. A API User limit permite que você venda um item em uma quantidade limitada. Para configurar os limites de compra, vá para a seção Admin do módulo de tipo de item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos ### Obtenha o número de itens disponíveis para o usuário especificado - [GET /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/user-limits-admin/get-user-item-limit.md): Obtém o número restante de itens disponíveis para o usuário especificado dentro do limite aplicado. A API User limit permite que você venda um item em uma quantidade limitada. Para configurar os limites de compra, vá para a seção Admin do módulo de tipo de item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos ### Aumente o número de itens disponíveis para o usuário especificado - [POST /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/user-limits-admin/add-user-item-limit.md): Aumenta o número restante de itens disponíveis para o usuário especificado dentro do limite aplicado. A API User limit permite que você venda um item em uma quantidade limitada. Para configurar os limites de compra, vá para a seção Admin do módulo de tipo de item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos ### Defina o número de itens disponíveis para o usuário especificado - [PUT /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/pt/api/shop-builder/user-limits-admin/set-user-item-limit.md): Define o número de itens que o usuário especificado pode comprar dentro do limite aplicado depois que ele foi aumentado ou diminuído. A API User limit permite que você venda um item em uma quantidade limitada. Para configurar os limites de compra, vá para a seção Admin do módulo de tipo de item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos ### Atualizar limite de compra - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/pt/api/shop-builder/user-limits-admin/reset-user-item-limit.md): Atualiza o limite de compra de um item para que um usuário possa comprá-lo novamente. Se o parâmetro user for null, essa chamada atualizará esse limite para todos os usuários. A API User limit permite que você venda um item em uma quantidade limitada. Para configurar os limites de compra, vá para a seção Admin do módulo de tipo de item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos ### 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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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 cadeias de ofertas - [GET /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/pt/api/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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. ## Admin ### Obter lista de recompensas diárias - [GET /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/pt/api/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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 informações sobre venda cruzada no projeto - [GET /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/pt/api/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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. ## Admin ### Obter status da importação de itens - [GET /v1/admin/projects/{project_id}/connectors/import_items/import/status](https://developers.xsolla.com/pt/api/shop-builder/connector-admin/get-items-import-status.md): Recupera informações sobre o andamento da importação de itens para o projeto. Essa chamada de API recupera dados da última importação realizada por meio da Conta de Distribuidor ou da API. ### Importar itens via arquivo JSON - [POST /v1/projects/{project_id}/import/from_external_file](https://developers.xsolla.com/pt/api/shop-builder/connector-admin/import-items-from-external-file.md): Importa itens para a Store a partir de um arquivo JSON por meio da URL especificada. Consulte a documentação para obter mais informações sobre a importação de um arquivo JSON.