get
https://api.autra.io/v1/acquiring/subscriptions//invoices
Lista as faturas da assinatura, da mais recente para a mais antiga (até 200).
Ciclo de uma fatura
status | Significa |
|---|---|
SCHEDULED | Criada 3 dias antes do vencimento; aguarda o dia |
OPEN | Cobrança em andamento |
PAID | Paga; paymentId aponta para o pagamento em GET /v1/acquiring/payments/{paymentId} |
RETRYING | Recusada; nova tentativa em nextAttemptAt, motivo em lastFailureCode/lastFailureReason. Sem nextAttemptAt: resultado em conciliação, a Autra não repete sozinha |
OVERDUE | Esgotou as 3 tentativas; a assinatura fica PAST_DUE |
CANCELED | Cancelada junto com a assinatura |
lastFailureCode traz o código de resposta do emissor (ABECS, ex.: 51 saldo insuficiente, 05 não autorizada, 54 cartão vencido) ou do adquirente; lastFailureReason é o texto para mostrar ao cliente.
Erros — corpo {"errors":[{"code":"...","msg":"..."}]}; msg detalha o campo quando é validação:
code | HTTP | Quando acontece | O que fazer |
|---|---|---|---|
MISSING_DOCUMENT_ID | 400 | Estabelecimento não informado. | Envie o header X-Merchant-Document (ou documentId). |
TENANT_REQUIRED | 400 | A credencial não identifica o tenant. | Gere o token com as credenciais do seu tenant (POST /v1/oauth/token). |
FEATURE_DISABLED | 403 | O módulo de assinaturas não está habilitado para o tenant. | Peça a habilitação à Autra. |
MERCHANT_NOT_FOUND | 404 | O documento não é de um estabelecimento do seu tenant. | Confira o CPF/CNPJ do estabelecimento. |
SUBSCRIPTION_NOT_FOUND | 404 | Assinatura não existe neste estabelecimento. | Confira o id. |
INVALID_DOCUMENT | 422 | Documento do estabelecimento malformado. | CPF com 11 ou CNPJ com 14 dígitos, só números. |
INTERNAL_ERROR | 500 | Falha interna. | Tente de novo; persistindo, fale com o suporte com o horário da chamada. |
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…