{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-@l10n/pt/api/catalog/index.yaml","sidebar":"sidebar-@l10n/pt/catalog-en.sidebars.yaml"},"props":{"definitionId":"@l10n/pt/api/catalog/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/pt/api/catalog","seo":{"title":"Visão geral","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"O carrinho é um mecanismo de compra que permite combinar vários itens em um único pedido. Um usuário pode comprar itens de qualquer tipo em qualquer quantidade com moedas reais, assim como usar [códigos promocionais](https://developers.xsolla.com/pt/api/liveops/promotions-promo-codes).\n\nO carrinho é armazenado no lado da Xsolla. O salvamento do carrinho entre sessões depende do usuário estar autorizado ou não:\n  * Para usuários autorizados, o carrinho é vinculado a um usuário específico e é salvo entre as sessões, desde que as solicitações sejam enviadas em nome do mesmo usuário.\n\n  * Para [usuários não autorizados](/pt/api/catalog/section/authentication/authentication-with-guest-access-support), salvar o carrinho depende se o cabeçalho `x-unauthorized-id` é passado. Para salvar o carrinho de um usuário não autorizado entre sessões, passe o mesmo `x-unauthorized-id` em toda solicitação. Essa opção só está disponível para a venda de chaves de jogo.\n\nVocê pode identificar o carrinho de duas maneiras: automaticamente pelo [JWT do usuário](https://developers.xsolla.com/pt/api/catalog/section/authentication/authentication-using-user's-jwt) ou por ID do carrinho (`cart_id`).\n\nA gestão do carrinho está disponível tanto no lado do cliente quanto no lado do servidor.\n\nNo lado do servidor, você pode preencher o carrinho com itens, por exemplo, ao restaurar uma sessão de usuário. As seguintes ações estão disponíveis no lado do cliente:\n\n* recuperar o carrinho do usuário atual ou um carrinho por ID\n* preencher o carrinho\n* atualizar itens no carrinho\n* excluir itens do carrinho\n\nPara comprar itens do carrinho, são usadas chamadas do cliente e do servidor para criação de pedidos.\n\nO tempo de vida (TTL) do carrinho é de 72 horas por padrão. Se o conteúdo for alterado, por exemplo, quando um novo item é adicionado, o TTL é estendido.\n\nApós um pagamento bem-sucedido, o carrinho não é esvaziado automaticamente. Para limpar o carrinho, use as chamadas de API do lado do cliente:\n  * [Excluir todos os itens do carrinho por ID do carrinho](/pt/api/catalog/cart-client-side/cart-clear-by-id).\n\n  * [Excluir todos os itens do carrinho atual](/pt/api/catalog/cart-client-side/cart-clear).\n\n  * [Excluir item do carrinho por ID do carrinho](/pt/api/catalog/cart-client-side/delete-item-by-cart-id) e [Excluir item do carrinho atual](/pt/api/catalog/cart-client-side/delete-item) — o carrinho é limpo ao excluir o último item dele.\n\nCenário de uso do carrinho:\n\n1. Implemente uma interface de loja onde o usuário selecionará os itens.\n\n2. Quando o usuário seleciona itens na loja, adicione-os ao carrinho, por exemplo, usando a chamada [Preenchar carrinho com itens](https://developers.xsolla.com/pt/api/catalog/cart-client-side/cart-fill). Na matriz de itens, você deve passar os SKUs e a quantidade necessária dos itens.\n\n3. Implemente a interface de visualização do carrinho. Quando o usuário navega ao carrinho, exiba seus conteúdos usando a chamada [Obter carrinho do usuário atual](https://developers.xsolla.com/pt/api/catalog/cart-client-side/get-user-cart). A resposta retornará informações sobre o peço final dos itens, incluindo descontos e promoções aplicadas.\n\n4. Implemente a abertura da interface de pagamento para pagar pelo pedido. Por exemplo, você pode usar a chamada [Criar pedido com todos os itens de um carrinho em particular](https://developers.xsolla.com/pt/api/catalog/payment-client-side/create-order-by-cart-id). A resposta retorna um token para abrir a interface de pagamento.\n\n5. Configure o rastreamento de status de pedidos, por exemplo, usando [webhooks](https://developers.xsolla.com/pt/webhooks/) para receber dados sobre itens pagos com sucesso prontamente e concedê-los ao usuário.\n\n<div class=\"note\">\n  <p><b>Nota</b></p>\n  <p>Para implementar a venda de itens no jogo e online, consulte o <a href=\"https://developers.xsolla.com/pt/virtual-goods/own-ui/\">guia de integração</a>.</p>\n</div>\n\n![Fluxo de carrinho e pagamento](https://cdn.xsolla.net/developers/current/images/api_docs/cart-payment-flow.svg)"},"itemId":"cart-and-payment-overview","disableAutoScroll":true,"metadata":{},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"xsolla.redocly.app","port":4000,"ipAddress":"216.73.217.101"},"lang":"pt","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/pt/api/catalog/cart-and-payment-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}