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: emissor ou adquirente ainda está processando.
4. captured ou paid: o pagamento está final o suficiente para fulfillment.
5. refused, canceled, refunded ou partially_refunded: interrompa ou reverta o fulfillment.

​

Exemplo de resposta que exige ação do cliente

{
  "id": "tr_2001",
  "status": "three_ds_required",
  "method": "credit_card",
  "amount": 2490,
  "currency": "BRL",
  "next_action": {
    "type": "three_ds_challenge",
    "challenge_session_id": "3ds_1001",
    "client_secret": "sec_1001",
    "expires_at": "2026-03-16T14:20:00.000Z"
  }
}

​

Guia de tratamento de status

• Não faça fulfillment em pending nem em three_ds_required.
• Faça fulfillment 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