Transferências
Do pagamento de entrada à entrega, em quatro etapas.
POST/v1/transfers
Cada mudança de etapa gera um webhook transfer.updated.
A transferência (trf_…) executa uma cotação válida. Ela tem um status geral e uma lista de stages.
Criação
Cotação travadaCREATION
Pagamento
PIX de entradaPAYMENT
Liquidação
Câmbio executadoSETTLEMENT
Entrega
Crédito no destinoDELIVERY
Status
COMPLETEDFAILEDREFUNDINGREFUNDEDEXPIREDCANCELLEDEnquanto avança, o status é PROCESSING.
Etapas
| Etapa | O que acontece |
|---|---|
CREATION | A cotação é travada |
PAYMENT | A Oxus aguarda e confere o pagamento de entrada |
SETTLEMENT | Câmbio pela rota escolhida |
DELIVERY | Crédito na conta de destino |
Etapas concluídas trazem reference: o E2E do PIX, o trace do ACH ou o hash on-chain.
Status
status | Significa |
|---|---|
PROCESSING | Em andamento |
COMPLETED | Valor creditado ao beneficiário |
FAILED | A entrega foi recusada no destino; o reembolso começa sozinho |
REFUNDING | Reembolso em andamento |
REFUNDED | O valor voltou para o cliente |
EXPIRED | O pagamento de entrada não chegou em 30 minutos |
CANCELLED | Cancelada antes do pagamento |
Uma falha depois da liquidação nunca deixa dinheiro parado: a transferência vai a FAILED, REFUNDING e REFUNDED, sem ação do parceiro. Se algo der errado antes da entrega, o parceiro pode pedir o reembolso.
Pagamento de entrada
A resposta de criação traz paymentInstructions:
- PIX:
pixCopyPastee prazo de pagamento. O PIX deve sair de uma conta do próprio cliente. - Stablecoin:
depositAddress,networke o valor exato.
Cancelamento
POST/v1/transfers/{transferId}/cancelPossível enquanto o pagamento de entrada não foi identificado. Depois disso, a resposta é 409 TRANSFER_NOT_CANCELLABLE e o caminho é o reembolso.