Roteiro de homologação
Os cenários que a sua integração precisa passar no sandbox antes da liberação de produção, com a preparação e o resultado esperado de cada um.
A homologação verifica o comportamento do seu sistema, não o da Accelerazione. Cada cenário abaixo provoca uma situação que acontece em produção (pagamento confirmado, recusa, desafio 3DS, evento repetido) e diz o que a sua integração deve fazer. Quando todos passarem, preencha o checklist de entrega e envie o resultado à equipe de integração.
Use apenas credenciais, recebedores e dados de teste do sandbox. Não faça pagamentos reais para executar este roteiro. Se um cenário não estiver habilitado para a sua conta, peça os dados à equipe de integração.
Cenários de pagamento
| Cenário | Como provocar | O que a integração deve fazer |
|---|---|---|
| Pix pendente | Crie uma cobrança Pix válida com um nome comum. | Exibir QR Code, valor e prazo e manter o pedido aguardando pagamento. |
| Pix confirmado | Onde a simulação estiver habilitada, crie a cobrança com customer.name igual a APPROVED. | Acompanhar por webhook ou consulta até Succeeded e concluir o pedido uma única vez. |
| Pix expirado | Crie a cobrança com paymentMethodOptions.pix.expiresInMinutes: 1 e não pague. | Retirar o QR Code depois do prazo, acompanhar Canceled pela consulta e continuar aceitando uma confirmação tardia. |
| Cartão aprovado | Use o cartão de aprovação dos dados de teste. | Ler status da resposta e registrar a aprovação no servidor. |
| Cartão com desafio | Envie threeDSecure: "required" com uma sessão 3DS válida. | Exibir o iframe e tratar os três finais: sucesso, recusa e processamento. |
| Cartão tokenizado | Crie um token e use-o numa nova cobrança. | Manter o mesmo fluxo de comprador, split e 3DS do cartão digitado. |
| Pix parcelado | Use o comprador de teste habilitado para a conta e conclua o checkout da Pagaleve. | Redirecionar, consultar o pagamento no retorno e aguardar a confirmação do servidor. |
| Checkout cancelado | Cancele ou deixe expirar o checkout da Pagaleve. | Detectar Canceled pela consulta, sem esperar webhook específico. |
| Estorno | Peça o estorno de uma cobrança Succeeded. | Tratar o 202 como pedido aceito e acompanhar o evento final pelo refundId. |
| Saque | Solicite um saque menor que o saldo disponível. | Tratar a resposta como pedido aceito e acompanhar o saque até um estado final. |
A simulação de Pix por nome depende de configuração do sandbox; confirme a disponibilidade no credenciamento. No Pix parcelado, use a identidade e o procedimento de teste fornecidos para a conta: os dados fictícios dos exemplos não garantem aprovação.
Cenários de resiliência
Estes testes não dependem de um método de pagamento. Eles verificam se a integração sobrevive às condições normais de um sistema distribuído: rede que falha, mensagens que se repetem e eventos que chegam fora de ordem.
| Teste | O que verificar |
|---|---|
Repetir a criação com a mesma Idempotency-Key | Nenhum PaymentIntent novo é gerado. Para saber o estado atual, a integração usa a consulta. |
| Repetir a chave com corpo diferente | A integração trata o 409 e mantém o vínculo com a tentativa original. |
| Reenviar um webhook já processado | O endpoint responde 200 sem duplicar entrega, baixa ou estorno. |
| Receber eventos fora de ordem | O pedido mantém o estado conciliado e consulta a API quando houver dúvida. |
| Cartão sem CEP | A integração trata o erro e orienta a correção dos dados. |
| Comprador volta da Pagaleve antes do webhook | A tela mostra "processando" até o servidor confirmar. |
| Fechar e reabrir o checkout durante o 3DS | A integração consulta o PaymentIntent e recupera a ação pendente, se ainda válida. |
| Repetir um estorno em andamento | O mesmo refundId é mantido e nenhuma devolução concorrente é aberta. |
Execute os cenários de recusa e de desafio com o tratamento de mensagens do navegador ativo. A autenticação 3DS concluída com sucesso não substitui a leitura do resultado da cobrança.
Evento de cobrança Webhook
Enviado à `postbackUrl` da cobrança quando ela chega a um desfecho. Responda **exatamente 200** depois de gravar o evento. Até três tentativas, com cerca de 60 segundos entre elas. Verifique `X-DM-Signature` (HMAC-SHA256 de `t + "." + corpo cru`).
Dados de teste
Cartões de teste do sandbox, o nome do titular que controla cada desfecho e como simular confirmações de Pix.