OxusAPI

On-ramp e off-ramp

De reais para stablecoins, e de stablecoins para moeda local.

On-ramp e off-ramp usam os mesmos recursos da remessa. Muda a conta de destino ou a forma de pagamento.

On-ramp

O cliente paga em PIX e recebe USDT ou USDC numa carteira.

POST /v1/customers/{customerId}/receivers
{
  "rail": "WALLET",
  "currency": "USDT",
  "holder": { "type": "INDIVIDUAL", "name": "Maria Oliveira", "relationship": "SELF", "country": "BRA" },
  "details": { "network": "TRON", "address": "TQrY8tryqsYVCYS3MFbtffiPp2ccyn4STm" }
}

A cotação com essa conta volta com type: "ON_RAMP". A etapa DELIVERY termina com o hash da transação on-chain em reference.

Sem volta on-chain

Transações em blockchain são irreversíveis. Peça ao cliente para confirmar a rede e o endereço antes de enviar.

Off-ramp

O cliente paga em USDT ou USDC e recebe em conta bancária.

POST /v1/quotes
{
  "customerId": "cus_8f2a91c04d7e",
  "receiverId": "rcv_…",
  "paymentMethod": "STABLECOIN",
  "sourceCurrency": "USDT",
  "sourceNetwork": "TRON",
  "amount": 100000,
  "amountType": "SOURCE"
}

A transferência devolve um depositAddress exclusivo e o valor exato a enviar. A etapa PAYMENT termina após as confirmações da rede, e a DELIVERY termina com o comprovante do rail (E2E do PIX ou trace do ACH).

Se houver reembolso, o valor volta em stablecoin para a carteira que fez o depósito. Por isso o depósito deve sair de uma carteira do próprio cliente, não de uma exchange.

Nesta página