Cobranças da assinatura (e as próximas)

GET

/api/partner/v1/subscriptions/{token}/charges

Todas as cobranças da assinatura, da mais nova para a mais antiga, com
as tentativas de cada uma, mais o bloco upcoming com até 3 cobranças
futuras. Escopo subscriptions:read.

Token inexistente e token de outra conta respondem o mesmo 404, com
o mesmo corpo de GET /subscriptions/{token}, em v1 e em v2.

Requisição

Authorization

Bearer Token

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros de Consulta

Respostas

🟢200

application/json

Cobranças paginadas e próximas cobranças.

Bodyapplication/json

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/partner/v1/subscriptions//charges?per_page=&page=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

{
    "data": [
        {
            "id": 812,
            "cycle_number": 2,
            "attempts_count": 1,
            "amount": "49.90",
            "status": "failed",
            "due_date": "2026-10-20",
            "expires_at": null,
            "paid_at": null,
            "billing_method": "pix_automatico",
            "attempts": [
                {
                    "id": 77,
                    "attempted_at": "2026-10-20T15:00:00+00:00",
                    "status": "failed",
                    "failure_reason": "insufficient_funds",
                    "amount": "49.90",
                    "provider": "woovi"
                }
            ],
            "payment": {
                "pix_code": null,
                "qr_code": null
            }
        }
    ],
    "upcoming": {
        "items": [
            {
                "cycle_number": 3,
                "due_date": "2026-11-19",
                "amount": "49.90",
                "billing_method": "pix_automatico",
                "projected": false
            },
            {
                "cycle_number": 4,
                "due_date": "2026-12-19",
                "amount": "49.90",
                "billing_method": "pix_automatico",
                "projected": true
            }
        ],
        "remaining_cycles": null
    },
    "meta": {
        "current_page": 1,
        "per_page": 50,
        "total": 1,
        "last_page": 1
    }
}

Modificado em 2026-10-30 00:52:45

Página anterior

Catálogo do que pode ser cobrado

Próxima página

Listar webhooks