{"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":"Conjuntos são grupos de itens vendidos como uma unidade única. Um conjunto pode incluir itens virtuais, moedas virtuais, pacotes de moedas virtuais, chaves de jogo, e outros conjuntos. Use conjuntos para criar pacotes de iniciantes, ofertas sazonais e ofertas especiais.\n\nUse os seguintes grupos de chamada de API com conjuntos:\n\n* Use chamadas de API da subseção <b>Admin</b> para criar, atualizar, excluir conjuntos e gerenciar sua visibilidade.\n* Use chamadas de API da subseção <b>Catálogo</b> para recuperar conjuntos.\n\nOs limites de compra são configurados pelo objeto `limits` ao criar ou atualizar um conjunto. Para mais informações, consulte a visão geral de [limites](/pt/api/catalog/limits-overview). Você também pode configurar [restrições regionais](https://developers.xsolla.com/pt/items-catalog/catalog-features/regional-restrictions/) para vender itens em países específicos.\n\n<div class=\"note\">\n  <b>Nota</b><br><br>\n    Para mais informações sobre a configuração de conjuntos, consulte a seção <a href=\"https://developers.xsolla.com/pt/items-catalog/items-type/bundles/\" target=\"_blank\">Conjuntos</a>.\n</div>\n\n<br>\n\n<b>Cenário de gestão de conjuntos:</b>\n\n1. Crie um conjunto usando a chamada de API [Criar conjunto](/pt/api/catalog/bundles-admin/admin-create-bundle). Para verificar o conjunto criado, use a chamada de API [Obter conjunto](/pt/api/catalog/bundles-admin/admin-get-bundle). Para recuperar todos os conjuntos no projeto, use a chamada de API [Obter lista de conjuntos](/pt/api/catalog/bundles-admin/admin-get-bundle-list).\n2. Se necessário, use a chamada de API [Atualizar conjunto](/pt/api/catalog/bundles-admin/admin-update-bundle) para modificar o conteúdo do conjunto ou as configurações.\n3. Implemente a lógica de exibição do conjunto na sua vitrine usando as chamadas de API [Obter lista de conjuntos](/pt/api/catalog/bundles-catalog/get-bundle-list), [Obter conjunto específico](/pt/api/catalog/bundles-catalog/get-bundle), ou [Obter lista de conjuntos por grupo especificado](/pt/api/catalog/bundles-catalog/get-bundle-list-in-group).\n4. Crie um pedido usando a seção [Carrinho e pagamento](/pt/api/catalog/cart-and-payment-overview). Por exemplo, para uma compra rápida, você pode usar a chamada de API [Criar pedido com o item especificado](/pt/api/catalog/payment-client-side/create-order-with-item), passando o SKU do conjunto. A resposta contém um token para abrir a interface de pagamento.\n5. Implemente usando a interface de pagamento para pagar pelo pedido.\n6. Configure o rastreamento de status de pedidos, por exemplo, usando [webhooks](https://developers.xsolla.com/pt/webhooks/overview) para receber dados sobre itens pagos com sucesso prontamente e concedê-los ao usuário.\n\n![Cenário de gestão de conjuntos](https://cdn.xsolla.net/developers/current/images/api_docs/bundles.png)"},"itemId":"bundles-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/bundles-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}