Endpoint: GET /subscriptions/seller/{seller_id}/plans/{plans_pk}/subscribers/{subscribers_pk}/payments/
Autenticação: JWT Bearer ou chave de API do vendedor.
Retorna todos os pagamentos da assinatura do assinante identificado por subscribers_pk, ordenados por created_at em ordem decrescente. Cada linha inclui a referência à transação (transaction) que registra a cobrança subjacente, permitindo cruzar informações financeiras quando necessário.

​
Pré-requisitos

  • O chamador precisa estar autenticado contra o vendedor identificado por seller_id.
  • O plano deve pertencer a esse vendedor e o assinante deve pertencer ao plano. A filtragem é estrita por subscriber=subscribers_pk, mas a hierarquia da URL ainda exige segmentos válidos para seller_id e plans_pk.

​
Parâmetros de rota

​
seller_id
string
required
UUID da conta unificada do vendedor.
​
plans_pk
string
required
UUID do plano de assinatura pai.
​
subscribers_pk
string
required
UUID do assinante pai.

​
Resposta

Array de pagamentos da assinatura, do mais recente para o mais antigo.
​
id
string
UUID do pagamento.
​
subscriber
string
UUID do assinante pai.
​
subscription_plan
string
UUID do plano pai.
​
transaction
string
UUID da transação unificada vinculada, ou null quando a cobrança ainda não foi tentada.
​
amount
string
Valor do pagamento em centavos de BRL (string).
​
payment_method
string
Um dos valores credit_card, boleto, pix.
​
payment_status
string
Um dos valores pending (pendente), paid (pago), failed (falhou), overdue (atrasado), canceled (cancelado).
​
due_date
string
Data/hora de vencimento do pagamento no formato ISO 8601.
​
paid_at
string
Data/hora de confirmação do pagamento em ISO 8601, ou null.
​
created_at
string
Data/hora de criação do registro de pagamento em ISO 8601.
[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef0123456789",
    "subscriber": "f4b1c7a9-8c2d-4d4f-9c3a-5e6f7a8b9c0d",
    "subscription_plan": "8b0e9f4a-2b7d-4f3f-9d8a-1c2e3a4b5c6d",
    "transaction": "22222222-3333-4444-5555-666666666666",
    "amount": "4990",
    "payment_method": "credit_card",
    "payment_status": "paid",
    "due_date": "2026-05-14T12:30:00-03:00",
    "paid_at": "2026-05-14T12:30:04-03:00",
    "created_at": "2026-05-14T12:30:00-03:00"
  }
]

​
Erros

StatusQuando
401Token ausente ou inválido.
403O chamador não está vinculado a este vendedor.
404O segmento de rota do plano ou do assinante não pôde ser resolvido.

​
Exemplos

curl https://api.dlpay.cloud/subscriptions/seller/SELLER_ID/plans/PLAN_ID/subscribers/SUBSCRIBER_ID/payments/ \
  -H "Authorization: Bearer $ACCESS_TOKEN"