API · Assinaturas

Consultar autorização

GET /api/crypto/v1/subscriptions/authorize/{ref} — dados para autorizar recorrência.

GET /api/crypto/v1/subscriptions/authorize/{ref}

Consulta uma referência de autorização gerada no modo authorization. A referência é hexadecimal com 64 caracteres, sem prefixo 0x; mantenha-a restrita ao fluxo do cliente.

curl 'https://api.caedral.com/api/crypto/v1/subscriptions/authorize/REFERENCIA_DE_AUTORIZACAO'

200 retorna subscriptionId, customerRef, endereços do cliente e lojista, description, amountBRL, token, amountToken, maxPerChargeToken, intervalDays, expiresAt, lastChargedAt, status, authorized, canceled, onchainSubId, chargerAddress, tokenAddress, chainId e network. Parte dos dados vem do contrato na Base.

404: referência malformada ou inexistente; 500: erro na consulta, inclusive ao contrato ou RPC. Esta rota consulta o estado: não concede autorização por si só.

Exemplo de resposta 200

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

{
  "subscriptionId": "674000000000000000000001",
  "customerRef": "cliente_1042",
  "customerAddress": "0x2222222222222222222222222222222222222222",
  "merchantAddress": "0x1111111111111111111111111111111111111111",
  "description": "Plano mensal",
  "amountBRL": 49.9,
  "token": "USDC",
  "amountToken": "9.33",
  "maxPerChargeToken": "9.33",
  "intervalDays": 30,
  "expiresAt": "2027-11-08T18:00:00.000Z",
  "lastChargedAt": null,
  "status": "active",
  "authorized": false,
  "canceled": false,
  "onchainSubId": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "chargerAddress": "0x3333333333333333333333333333333333333333",
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "chainId": 8453,
  "network": "Base"
}