API · Ordens

Confirmar intenção

POST /api/crypto/v1/payment-intents/{id}/confirm — escolha rede e ativo.

POST /api/crypto/v1/payment-intents/{id}/confirm

Converte uma intenção ainda válida em ordem. A intenção é criada quando uma requisição de ordem omite simultaneamente rede e token; ela expira após 15 minutos.

Campo Tipo Descrição
id caminho intentId retornado na criação.
chain JSON Rede explícita disponível; auto não é aceito.
token JSON Ativo explícito disponível; auto não é aceito.
curl -X POST 'https://api.caedral.com/api/crypto/v1/payment-intents/INTENT_ID/confirm' \
  -H 'Content-Type: application/json' -d '{"chain":"base","token":"USDC"}'

201 retorna os dados formatados da ordem criada, inclusive ref, paymentUrl, qrCodeUrl e statusUrl. Preserve a referência retornada. A resposta desta rota não é idêntica ao objeto reduzido de POST /orders.

400: rede ou ativo inválido ou falha de criação; 404: intenção inexistente ou expirada; 409: intenção já confirmada; 429: limite compartilhado com criação. A resposta 409 não devolve a referência da ordem: persista a resposta 201.

Exemplo de resposta 201

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

{
  "ref": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "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"
    ]
  },
  "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",
  "merchantAddress": "0x1111111111111111111111111111111111111111",
  "botID": null,
  "rateLocked": 5.35
}