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.