Skip to content
Xfin Developers

Cotação com mínimo garantido

Ao criar um payout, a Xfin não apenas cota a taxa de câmbio do momento — ela garante um mínimo de USDT que o destinatário receberá. Esse valor está no campo min_amount_usdt da resposta.

O problema: spread revelado só pós-liquidação

A liquidação USDT é feita via 4Pay Finance, que aplica um spread sobre a cotação spot no momento da liquidação. Esse spread final só é conhecido depois que o provedor executa a conversão — não no momento da criação do payout.

Isso significa que, se cotássemos apenas a taxa spot, o valor entregue poderia ser menor do que o exibido ao cliente no momento do checkout.

A solução: buffer de spread

Para proteger o cliente, a Xfin aplica um buffer de spread conservador sobre a taxa spot no momento da criação:

min_amount_usdt = (amount_brl / taxa_spot) * (1 - buffer_spread)

O resultado é um valor que o cliente definitivamente receberá ao menos, mesmo considerando o pior caso de spread da 4Pay.

Os dois campos de valor USDT

CampoQuando disponívelSignificado
min_amount_usdtDesde a criação (PENDING)Mínimo garantido de USDT — o piso que o destinatário receberá
settled_amount_usdtApós liquidação (COMPLETED)USDT efetivamente entregue na carteira — sempre >= min_amount_usdt

Exemplo em números

Suponha que o cliente queira converter R$ 100,00 em USDT:

  • Taxa spot no momento: 1 USDT = R$ 5,44
  • Buffer de spread aplicado: 5%
  • min_amount_usdt = (100 / 5.44) × (1 - 0.05) ≈ 17,46 USDT

Quando o pagamento é confirmado e a 4Pay liquida:

  • Spread real da 4Pay: 3% (menor que o buffer)
  • settled_amount_usdt = (100 / 5.44) × (1 - 0.03) ≈ 17,97 USDT

O destinatário recebeu mais que o mínimo garantido. O cliente saiu ganhando.

Resposta de exemplo

No momento da criação (status: PENDING):

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "PENDING",
  "amount_brl": 100.00,
  "min_amount_usdt": 18.37,
  "settled_amount_usdt": 0
}

Após liquidação (status: COMPLETED):

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "COMPLETED",
  "amount_brl": 100.00,
  "min_amount_usdt": 18.37,
  "settled_amount_usdt": 19.38
}

settled_amount_usdt (19,38) é maior que min_amount_usdt (18,37) — o cliente recebeu mais USDT do que o prometido.

Qual campo usar na sua integração

  • Checkout / confirmação ao cliente: use min_amount_usdt. É o valor que você pode exibir com segurança antes do pagamento.
  • Comprovante pós-liquidação: use settled_amount_usdt. É o valor real transferido para a carteira do cliente.
  • Auditoria e reconciliação: compare os dois. A diferença positiva indica o benefício do buffer — o cliente nunca recebe menos que o prometido.