API · Auxiliares

Consultar checkout público

GET /api/crypto/public/{ref} — dados públicos da página de pagamento.

GET /api/crypto/public/{ref}

Retorna dados necessários para o checkout, incluindo ref, status, valores, token, rede, endereço do contrato e do lojista, paymentUri, qrCodeUrl, expiração, hash e descrição. Também expõe tokenMode e acceptedTokens. Quem possui a referência pode visualizar esses dados; compartilhe-a apenas com quem precisa pagar ou acompanhar.

curl 'https://api.caedral.com/api/crypto/public/REF_DA_ORDEM'

200: objeto público; 404: ordem não encontrada; 500: erro interno. Para integrações novas, consulte também Consultar ordem, que usa o contrato público da API v1.

Exemplo de resposta 200

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",
  "paymentUri": "ethereum:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913@8453/transfer?address=0x3333333333333333333333333333333333333333&uint256=28000000",
  "qrCodeUrl": "https://api.caedral.com/api/crypto/v1/orders/0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/qr",
  "expiresAt": "2026-11-08T18:15:00.000Z",
  "payableUntil": "2026-11-08T19:00:00.000Z",
  "paidAt": null,
  "txHash": null,
  "description": "Pedido PED-1042",
  "merchantAddress": "0x1111111111111111111111111111111111111111",
  "tokenMode": "fixed",
  "acceptedTokens": []
}