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"
}