` é o token do usuário. O token identifica o usuário e fornece acesso a dados personalizados. Alternativamente, você pode usar um [token para abrir a interface de pagamento](/pt/api/pay-station/token/create-token).\n\n2. **Modo simplificado sem o cabeçalho Authorization.** Esse modo é usado apenas para usuários não autorizados e pode ser aplicado apenas para [vendas de chaves de jogo](/pt/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users). Em vez de um token, a solicitação deve incluir os seguintes cabeçalhos:\n - `x-unauthorized-id` com um ID de solicitação\n - `x-user` com o endereço de e-mail do usuário codificado em Base64\n\n## Links úteis\n\n- [Chamadas de API por modelo de interação](https://developers.xsolla.com/pt/api/catalog/)\n- [Tipos de ponto de extremidade](https://developers.xsolla.com/pt/api/catalog/)\n- [Tratamento de erros](https://developers.xsolla.com/pt/api/catalog/)\n- [Chaves de API](https://developers.xsolla.com/pt/api/catalog/)\n\n# Estrutura da entidade principal\n\nItens de todos os tipos (itens virtuais, pacotes, moeda virtual e chaves) usam uma estrutura de dados semelhante. Compreender a estrutura básica simplifica o trabalho com a API e ajuda a navegar na documentação com mais facilidade.\n\nNota
Algumas chamadas podem incluir campos adicionais, mas eles não alteram a estrutura básica.
\n\n**Identificação**\n\n- `merchant_id` — ID da empresa na [Conta de Distribuidor](https://publisher.xsolla.com/)\n- `project_id` — ID do projeto na Conta de Distribuidor\n- `sku` — SKU do item, único dentro do projeto\n\n**Exibição na loja**\n\n- `name` — nome do item\n- `description` — descrição do item\n- `image_url` — URL da imagem\n- `is_enabled` — disponibilidade do item\n- `is_show_in_store` — se o item é exibido no catálogo\n\nPara mais informações sobre como gerenciar a disponibilidade de itens no catálogo, consulte a [documentação](/pt/items-catalog/catalog-features/items-availability/).\n\n**Organização**\n\n- `type` — tipo de item, por exemplo, um item virtual (`virtual_item`) ou conjunto (`bundle`)\n- `groups` — grupos aos quais o item pertence\n- `order` — ordem de exibição no catálogo\n\n**Condições de venda**\n\n- `prices` — preços em moeda real ou virtual\n- `limits` — limites de compra\n- `periods` — períodos de disponibilidade\n- `regions` — restrições regionais\n\n**Exemplo de estrutura da entidade principal:**\n\n```json\n{\n \"attributes\": [],\n \"bundle_type\": \"virtual_currency_package\",\n \"content\": [\n {\n \"description\": {\n \"en\": \"Main in-game currency\"\n },\n \"image_url\": \"https://.../image.png\",\n \"name\": {\n \"en\": \"Crystals\",\n \"de\": \"Kristalle\"\n },\n \"quantity\": 500,\n \"sku\": \"com.xsolla.crystal_2\",\n \"type\": \"virtual_currency\"\n }\n ],\n \"description\": {\n \"en\": \"Crystals x500\"\n },\n \"groups\": [],\n \"image_url\": \"https://.../image.png\",\n \"is_enabled\": true,\n \"is_free\": false,\n \"is_show_in_store\": true,\n \"limits\": {\n \"per_item\": null,\n \"per_user\": null,\n \"recurrent_schedule\": null\n },\n \"long_description\": null,\n \"media_list\": [],\n \"name\": {\n \"en\": \"Medium crystal pack\"\n },\n \"order\": 1,\n \"periods\": [\n {\n \"date_from\": null,\n \"date_until\": \"2020-08-11T20:00:00+03:00\"\n }\n ],\n \"prices\": [\n {\n \"amount\": 20,\n \"country_iso\": \"US\",\n \"currency\": \"USD\",\n \"is_default\": true,\n \"is_enabled\": true\n }\n ],\n \"regions\": [],\n \"sku\": \"com.xsolla.crystal_pack_2\",\n \"type\": \"bundle\",\n \"vc_prices\": []\n}\n```\n\n# Fluxo básico de compra\n\nA Xsolla API permite implementar a lógica de loja no jogo, incluindo a recuperação do catálogo de itens, gerenciamento do carrinho, criação de pedidos e acompanhamento de seu status. Dependendo do cenário de integração, as chamadas de API são divididas em subseções **Admin** e **Catalog**, que usam diferentes [esquemas de autenticação](/pt/api/catalog/section/authentication).\n\nO exemplo a seguir mostra um fluxo básico para configurar e operar uma loja, desde a criação de itens até a compra.\n\n## Criar itens e grupos (Admin)\n\nCrie um catálogo de itens para sua loja, como itens virtuais, pacotes ou moeda virtual.\n\nExemplos de chamadas de API:\n- [Criar item virtual](/pt/api/catalog/virtual-items-currency-admin/admin-create-virtual-item)\n- [Criar conjunto](/pt/api/catalog/bundles-admin/admin-create-bundle)\n- [Criar moeda virtual](/pt/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency)\n\n## Configurar promoções, cadeias e limites (Admin)\n\nConfigure ferramentas de aquisição de usuários e monetização, como descontos, bônus, recompensas diárias ou cadeias de ofertas.\n\nExemplos de chamadas de API:\n- [Criar promoção de bônus](/pt/api/liveops/promotions-bonuses/create-bonus-promotion)\n- [Criar recompensa diária](/pt/api/liveops/daily-chain-admin/admin-create-daily-chain)\n- [Criar promoção de oferta única no catálogo](/pt/api/liveops/promotions-unique-catalog-offers/admin-create-unique-catalog-offer)\n\n## Obter informações do item (Cliente)\n\nConfigure a exibição do item em sua aplicação.\n\n\n
Aviso\n Não use chamadas de API da subseção Admin para construir um catálogo de usuários. Essas chamadas de API têm
limites de taxa e não são destinadas para tráfego de usuários.\n
\n\nExemplos de chamadas de API:\n- [Obter lista de itens virtuais](/pt/api/catalog/virtual-items-currency-catalog/get-virtual-items)\n- [Obter lista de grupos de itens](/pt/api/catalog/virtual-items-currency-catalog/get-item-groups)\n- [Obter lista de conjuntos](/pt/api/catalog/bundles-catalog/get-bundle-list)\n- [Obter lista de itens vendáveis](/pt/api/catalog/common-catalog/get-sellable-items)\n\n\n Nota
\n Por padrão, as chamadas de API do catálogo retornam itens que estão atualmente disponíveis na loja no momento da solicitação. Para recuperar itens que ainda não estão disponíveis ou que não estão mais disponíveis, inclua o parâmetro \"show_inactive_time_limited_items\": 1 na solicitação do catálogo.\n
\n\n## Vender itens\n\nVocê pode vender itens usando os seguintes métodos:\n- Compra rápida — vender um SKU várias vezes.\n- Compra de carrinho — o usuário adiciona itens ao carrinho, remove itens e atualiza quantidades dentro de um único pedido.\n\nSe um item for comprado usando moedas virtuais em vez de moedas reais, use a chamada de API [Criar pedido com item especificado comprado por moeda virtual](/pt/api/catalog/virtual-payment/create-order-with-item-for-virtual-currency). A interface de pagamento não é necessária, pois a cobrança é processada quando a chamada de API é executada.\n\nPara a compra de itens gratuitos, use a chamada de API [Criar pedido com item gratuito especificado](/pt/api/catalog/free-item/create-free-order-with-item) ou a chamada de API [Criar pedido com carrinho gratuito](/pt/api/catalog/free-item/create-free-order). A interface de pagamento não é necessária — o pedido é imediatamente definido ao status done.\n\n### Compra rápida\n\nUse a chamada de API do lado do cliente para [criar um pedido com um item especificado](/pt/api/catalog/payment-client-side/create-order-with-item). A chamada retorna um token usado para abrir a interface de pagamento.\n\n\n Nota
\n As informações de desconto estão disponíveis para o usuário apenas na interface de pagamento. Códigos promocionais não são suportados.\n
\n\n### Compra via carrinho\n\nA configuração e compra do carrinho podem ser realizadas no lado do cliente ou no lado do servidor.\n\n**Configure e compre um carrinho no cliente**\n\nImplemente a lógica de adicionar e remover itens por conta própria. Antes de chamar a API para configurar um carrinho, você não terá informações sobre quais promoções serão aplicadas à compra. Isso significa que o custo total e os detalhes dos itens bônus adicionados não serão conhecidos.\n\nImplemente a seguinte lógica de carrinho:\n1. Após o jogador ter preenchido um carrinho, use a chamada de API [Preencher carrinho com itens](/pt/api/shop-builder/operation/cart-fill/). A chamada retorna as informações atuais sobre os itens selecionados (preços antes e depois dos descontos, itens bônus).\n2. Atualize o conteúdo do carrinho com base nas ações do usuário:\n - Para adicionar um item ou alterar a quantidade de um item, use a chamada de API [Atualizar item do carrinho por ID do carrinho](/pt/api/shop-builder/operation/put-item-by-cart-id/).\n - Para remover um item, use a chamada de API [Excluir item do carrinho por ID do carrinho](/pt/api/shop-builder/operation/delete-item-by-cart-id/).\n\n\n Nota
\n Para obter o status atual do carrinho, use a chamada de API Obter carrinho do usuário atual.\n
\n\n3. Use a chamada de API [Criar pedido com todos os itens do carrinho atual](/pt/api/shop-builder/operation/create-order/). A chamada retorna o ID do pedido e o token de pagamento. O pedido recém-criado é definido para o status new por padrão.\n\n**Configure e compre um carrinho no servidor**\n\nEsta opção de configuração pode levar mais tempo para configurar o carrinho, já que cada alteração no carrinho deve ser acompanhada por chamadas de API.\n\nImplemente a seguinte lógica de carrinho:\n1. Após o jogador ter preenchido um carrinho, use a chamada de API [Preencher carrinho com itens](/pt/api/catalog/cart-server-side). A chamada retorna informações atuais sobre os itens selecionados (preços antes e depois dos descontos, itens bônus).\n2. Use a chamada de API [Criar pedido com todos os itens do carrinho atual](/pt/api/shop-builder/operation/create-order/). A chamada retorna o ID do pedido e o token de pagamento. O pedido recém-criado é definido ao status new por padrão.\n\n## Abertura da interface de pagamento\n\nUse o token retornado para abrir a interface de pagamento em uma nova janela. Outras maneiras de abrir a interface de pagamento estão descritas na [documentação](/pt/payment-ui-and-flow/payment-ui/how-to-open-payment-ui/#open_payment_ui).\n\n| Ação | Endpoint |\n|:--------------------------------|:--------------------------------------------------------------------------|\n| Abrir no ambiente de produção. | https://secure.xsolla.com/paystation4/?token={token} |\n| Abrir no modo sandbox. | https://sandbox-secure.xsolla.com/paystation4/?token={token} |\n\n\n
Nota\n Use o modo sandbox durante o desenvolvimento e teste. Compras de teste não fazem cobranças de contas reais. Você pode usar
cartões de teste.\n\n Após o primeiro pagamento real, uma política de pagamento sandbox estrita entra em vigor. Um pagamento no modo sandbox está disponível apenas para usuários especificados em [Conta de Distribuidor > Configurações da Empresa > Usuários](https://publisher.xsolla.com/0/settings/users).\n\n Comprar moedas e itens virtuais por moedas reais é possível apenas após assinar um acordo de licença com a Xsolla. Para isso, na [Conta de Distribuidor](https://publisher.xsolla.com/), acesse **Contratos & Impostos > Contratos**, preencha o formulário do acordo e aguarde a confirmação. Pode levar até 3 dias úteis para revisar o contrato.\n