Pular para o conteúdo principal

Listar cobranças de uma assinatura

GET/api/v1/subscriptions/:id/charges/
{
"status": "success",
"data": [
{
"id": 791,
"subscriptionId": 12,
"status": 2,
"value": 2990,
"amount": 29.9,
"dueDate": "2026-10-09",
"acquirerPaymentId": "b7a3e1f2-0c4d-4e8a-9f61-2d5c8a7e4b10",
"denialCode": "05",
"denialMessage": "Not Authorized",
"attempts": 1,
"nextRetryAt": "2026-10-10",
"paymentTransactionId": null,
"createdAt": "2026-10-09T09:00:02.11Z",
"updatedAt": "2026-10-09T09:00:03.45Z"
},
{
"id": 790,
"subscriptionId": 12,
"status": 1,
"value": 2990,
"amount": 29.9,
"dueDate": "2026-09-09",
"acquirerPaymentId": "0279e54a-88df-4b06-874b-65785c45a19f",
"denialCode": "",
"denialMessage": "",
"attempts": 1,
"nextRetryAt": null,
"paymentTransactionId": 63,
"createdAt": "2026-09-09T19:48:57.304828Z",
"updatedAt": "2026-09-09T19:48:58.17205Z"
}
]
}
CampoDescrição
status0 PENDING · 1 CONFIRMED · 2 DENIED · 3 REFUNDED
valueValor desta cobrança, em centavos. É o valor cobrado no adquirente, inclusive nas retentativas
acquirerPaymentIdIdentificador da transação no adquirente
denialCodeCódigo do adquirente da tentativa negada. Preenchido só quando a cobrança está negada — vazio em cobrança confirmada ou estornada. transport_error indica falha de comunicação com o adquirente
denialMessageMensagem do adquirente da tentativa negada. Mesma regra
attemptsQuantas vezes a cobrança foi enviada ao adquirente, contando retentativas. Com a retentativa desligada, é sempre 1
nextRetryAtData da próxima retentativa, YYYY-MM-DD. null quando não há retentativa agendada — sempre null com a retentativa desligada e em assinatura cancelada ou expirada
paymentTransactionIdTransação financeira gerada quando confirmada. null quando não houve
aviso

Para saber se a cobrança foi negada, use status, não denialCode. status: 2 com nextRetryAt preenchido ainda será tentada de novo (Retentativa de cobrança negada); com nextRetryAt: null, a negação é final.