API · Ordens

Trocar rede ou ativo

POST /api/crypto/v1/orders/{ref}/redirect — crie uma nova rota para o pagamento.

POST /api/crypto/v1/orders/{ref}/redirect

A referência funciona como capability para operar uma ordem pendente. O corpo aceita chain e token; campos como carteira, valor, afiliados, descrição e webhook são herdados, não substituídos pelo corpo.

curl -X POST 'https://api.caedral.com/api/crypto/v1/orders/REF_DA_ORDEM/redirect' \
  -H 'Content-Type: application/json' -d '{"chain":"polygon","token":"USDC"}'

A troca de ativo exige que a ordem original tenha token: "auto" ou o ativo conste em acceptedTokens. Sem autorização, apenas a rede pode mudar mantendo o ativo. Consulte /chains para disponibilidade.

200 retorna uma nova ordem e previousRef. A ordem anterior passa a redirected, mas segue monitorada: um pagamento tardio pode ser reconciliado e duplicidades detectadas. A expiração original é preservada; apresente somente a referência mais recente ao comprador.

400: entrada ou ativo inválido; 403: troca de ativo não autorizada; 404: ordem inexistente; 409: ordem não está pendente; 410: janela encerrada; 429: limite de redirecionamentos ou limite de IP (10 em cinco minutos). O código limita a cadeia de redirecionamentos a cinco.

Exemplo de resposta 200

Os valores são ilustrativos e variam conforme o ambiente e a ordem.

{
  "ref": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
  "status": "pending",
  "amountBRL": 149.9,
  "cryptoAmount": "28.000000",
  "feeAmount": "0.280000",
  "minFeeAmount": "0.10",
  "feeModel": null,
  "netAmount": "27.720000",
  "token": "USDC",
  "tokenLabel": "USD Coin",
  "tokenDecimals": 6,
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "chain": "base",
  "chainId": 8453,
  "chainParams": {
    "chainIdHex": "0x2105",
    "chainName": "Base",
    "rpcUrls": [
      "https://mainnet.base.org"
    ],
    "nativeSymbol": "ETH",
    "blockExplorerUrls": [
      "https://basescan.org"
    ]
  },
  "recipient": "0x1111111111111111111111111111111111111111",
  "contractAddress": "0x3333333333333333333333333333333333333333",
  "contractVersion": "v4",
  "feeBps": 100,
  "paymentUrl": "https://pay.example/pay/0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "paymentUri": "ethereum:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913@8453/transfer?address=0x3333333333333333333333333333333333333333&uint256=28000000",
  "qrCodeUrl": "https://api.caedral.com/api/crypto/v1/orders/0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/qr",
  "statusUrl": "https://api.caedral.com/api/crypto/v1/orders/0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "expiresAt": "2026-11-08T18:15:00.000Z",
  "payableUntil": "2026-11-08T19:00:00.000Z",
  "createdAt": "2026-11-08T18:00:00.000Z",
  "paidAt": null,
  "txHash": null,
  "description": "Pedido PED-1042",
  "previousRef": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}