Este fluxo descreve como funcionam os pagamentos com cartão na Autra Platform, incluindo as etapas, estados e eventos envolvidos desde a criação da transação até sua conclusão.
Resumo
O fluxo de pagamento com cartão é indicado para operações que exigem autorização junto à adquirência, podendo envolver captura posterior, cancelamento ou outras ações conforme o modelo de negócio.
Esse fluxo pode ser utilizado em:
- Checkouts online
- Pré-Autorizações
- Pagamentos à vista ou parcelado
- Tokenização do cartão
Etapas do fluxo
- Criação da transação de pagamento
- Envio da transação para autorização
- Processamento pela adquirência
- Retorno do resultado da autorização
- Emissão de eventos de status
- Captura ou cancelamento, quando aplicável
Estados
Estados comuns de uma transação com cartão:
-
CREATED
A transação foi criada, mas ainda não enviada para autorização. -
AUTHORIZED
O pagamento foi autorizado pela adquirência. -
DECLINED
O pagamento foi recusado. -
CAPTURED
O valor autorizado foi capturado. -
VOIDED
A transação foi cancelada antes da captura.
Cada transação percorre seu lifecycle de acordo com o modelo configurado (captura imediata ou posterior).
Eventos
Ao longo do fluxo, a Autra emite eventos que representam mudanças relevantes de estado, como:
- CARD_PAYMENT_CREATED
- CARD_PAYMENT_AUTHORIZED
- CARD_PAYMENT_DECLINED
- CARD_PAYMENT_CAPTURED
- CARD_PAYMENT_VOIDED
Os eventos são enviados via webhook e devem ser utilizados como fonte de verdade do estado da transação.
Pontos de atenção
- A resposta síncrona indica apenas o resultado imediato da requisição
- O estado final deve ser confirmado via evento
- Trate eventos de forma idempotente
- Utilize identificadores externos (
external_id) para correlação - Nem toda autorização resulta em captura automática
Próximos passos
Para detalhes técnicos, consulte os endpoints de Adquirência na API Reference.