Recebendo o pagamento

O que a BlendFi faz quando o cliente final paga o QR Pix. Caminhos pagamento confirmado e janela expirada.

Após o aceite, a BlendFi observa o pagamento Pix. O Pix é atômico no provedor: ou o cliente final paga o valor exato dentro da janela, ou não paga.

Os dois caminhos

1. Pagamento dentro da janela → `funded` → liquidação automática

O caminho feliz. O cliente final paga o QR Pix antes de deposit_window_expires_at. A BlendFi recebe a confirmação do provedor Pix, a conversão transita para funded, a liquidação on-chain avança automaticamente e a conversão termina em completed. Você recebe conversion.completed.

Você não precisa chamar nada. A liquidação é totalmente automática a partir de funded.

2. Janela expirada sem pagamento → `expired`

Se a janela passa sem pagamento confirmado, a conversão transita para expired (terminal), a reserva de limite é liberada, o lock é solto. Não há pagamento para tratar.

Por que onramp não tem standby

Diferente do offramp, o Pix é atômico no provedor. Não existe "Pix parcial" nem "Pix com valor errado": o pagamento ou bate exatamente o valor cotado, ou não é confirmado. Isso elimina os cenários de under_funded e over_funded que existem no offramp.

Webhooks que você recebe

Cenário	Webhook
Pagamento dentro da janela + liquidação on-chain ok	`conversion.completed`
Pagamento dentro da janela + liquidação falha	`conversion.failed`
Janela expirada sem pagamento	(sem webhook dedicado; conversão fica em `expired`)

A semântica completa de webhooks vai na seção de Webhooks.

Tempo total típico

Do aceite até conversion.completed, o caminho feliz é tipicamente:

0 a 15 min: cliente final paga o QR Pix.
~10s após o pagamento: provedor Pix confirma.
Segundos a minutos: liquidação on-chain confirma.
conversion.completed dispara.

Veja USDT no glossário para detalhes sobre tempo de confirmação on-chain.

Não dependa de comportamento síncrono

Mesmo na Polygon, a liquidação on-chain pode levar de segundos a minutos sob carga. Reaja ao webhook, não a polling apertado.

Próximo passo

Cancelamento: como sair antes de o pagamento chegar.