Ciclo de vida da transação de cartão

​

Ciclo de vida típico

1. pending: a transação foi criada.
2. three_ds_required: o cliente precisa concluir a autenticação.
3. authorized ou processing: o processamento do cartão ainda está em andamento.
4. captured ou paid: o pagamento está final o suficiente para liberar o pedido.
5. refused, canceled, refunded ou partially_refunded: interrompa ou reverta a liberação.

​

Exemplo de resposta que exige ação do cliente

{
  "id": "018f1f2e-7b43-7c9a-8d3e-1a2b3c4d5e70",
  "status": "three_ds_required",
  "method": "credit_card",
  "amount": 2490,
  "currency": "BRL",
  "next_action": {
    "type": "three_ds_challenge"
  }
}

​

Guia de tratamento de status

• Não libere o pedido em pending nem em three_ds_required.
• Libere o pedido apenas uma vez ao chegar em um estado liquidado como captured ou paid.
• Se o fluxo do navegador terminar de forma inesperada, reconcilie com GET /v2/transactions/{id}.
• Trate reembolso e chargeback como fluxos financeiros separados.

​

Leia a seguir

• Payment Element para pagamentos com cartão
• 3D Secure
• Status de transação