Pular para o conteúdo principal
Use esta página para mapear estados de cartão para pedido e liberaçã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 do cartão ou provedor de pagamento ainda está processando.
  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": "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 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