API GiftCard Hub API

Conheça a plataforma

O que integrar com GiftCard Hub API

Descrição técnica preservada da especificação de origem. A versão do contrato ajuda a identificar a API; confirme a disponibilidade atual no fornecedor.

>ℹ️ Check the new Payments onboarding guide. We created this guide to improve the onboarding experience for developers at VTEX. It assembles all documentation on our Developer Portal about Payments and is organized by focusing on the developer's journey. The Gift Card Hub API allows interactions with all Gift Card providers registered to a store from a single point. Gift Card providers are systems capable of providing cards to be used in the buying process. The following is the sequence diagram that represents calls in the purchase closing process. Checkout + Gateway: Systems responsible for the sale and for processing orders and payments. Gift Card Hub: System responsible for managing multiple registered Gift Card providers for a store. Gift Card Provider: System responsible for providing the Gift Cards available to the user not closing a purchase. This system can be implemented by third parties.

Do planejamento à produção

Checklist para integrar GiftCard Hub API

1. Defina o fluxo. Identifique quais dados precisam circular, o sistema de origem e o resultado esperado.
2. Leia os requisitos oficiais. Verifique acesso à API, plano necessário, versão e ambiente de testes.
3. Configure o acesso com segurança. Guarde credenciais secretas no servidor e conceda apenas as permissões necessárias. Restrinja chaves públicas conforme a documentação do fornecedor.
4. Teste a primeira requisição. Valide os campos, a paginação e o formato de resposta com dados de teste.
5. Prepare o tratamento de falhas. Considere limites de requisição, retentativas com espera e prevenção de operações duplicadas.
6. Acompanhe a integração. Registre erros sem expor dados sensíveis e monitore alterações na API.