Ciclo da transação

Todo pagamento com o cartão faz o mesmo caminho, da maquininha até a liquidação na rede. Entender esse ciclo ajuda a montar saldos e extratos certos.

API v1 · Legado

Esta página faz parte da referência da primeira versão da API da Web3Card, mantida aqui para consulta. A API v1 não recebe integrações novas: a API v2 a substitui, e a plataforma hoje funciona como descrito no resto deste manual.

Etapas

Authorization → Clearing → Settlement (on-chain)

1. Autorização

O portador aproxima ou digita o cartão. A Visa leva o pedido de autorização até a Web3Card, que confere na hora:

• A situação do cartão é active
• O valor está dentro do limite diário do cartão
• O saldo do cofre cobre o valor

Se tudo passa, o valor fica reservado e o lojista recebe a aprovação, normalmente em menos de um segundo. A transação aparece com a situação pending.

2. Compensação

O lojista envia a captura final (em geral em horas, até alguns dias em hotéis e parecidos). O valor capturado substitui a reserva; pequenas diferenças (gorjeta, ajuste de câmbio) são normais.

3. Liquidação

O valor capturado é liquidado a partir do cofre do usuário: o operador de liquidação cossigna uma transferência para fora do cofre, e o dinheiro segue até o banco emissor como liquidação padrão da Visa. A transação passa a settled, e o hash da transferência na rede fica anexado ao registro.

Situações da transação

Situação	Significado
pending	Autorizada, valor reservado
settled	Compensada e liquidada na rede
declined	Autorização recusada (limite, saldo, situação do cartão)
reversed	Autorização liberada sem captura
refunded	Estorno do lojista devolvido ao cofre
disputed	Contestação em andamento

Estornos e disputas

Os estornos chegam ao cofre como transações de crédito separadas. As disputas podem ser abertas pela API em até 60 dias depois da liquidação; veja a API de transações.

Eventos na hora

Cada mudança de situação gera um webhook (transaction.created, transaction.updated), para o seu app mostrar os pagamentos ao vivo. Veja Webhooks.