Fluxo de solicitação da API de produção

Ordem de solicitação recomendada para operações em tempo real com escopo de propriedade explícito e auditabilidade de transação.

1. Autentique e obtenha o JWT do usuário ou a chave API do aplicativo.
2. Crie ou atualize produtos por meio de /v1/products (POST, PUT, PATCH); ver Produtos API CRUD e exemplos multilíngues.
3. Inicie a finalização da compra em Pay com o ID do produto.
4. Receber e validar assinaturas de retorno de chamada/webhook (payment.confirmed + validação de espelho).
5. Consultar resultados de transações de /v1/transaction/status ou /v1/transactions - ver Detalhes da transação.

Cabeçalhos obrigatórios

Authorization: Bearer <token>
Content-Type: application/json

Linha de base de tratamento de erros

• Tente novamente falhas transitórias (5xx) com espera exponencial.
• Tratar 401/403 como problemas de autorização/permissão.
• Tratar 409 como conflitos comerciais (por exemplo, bloqueadores de exclusão de produtos).
• Registrar IDs de transação, IDs de eventos de webhook e IDs de solicitação para rastreabilidade.