Endpoint: GET /subscriptions/seller/{seller_id}/plans/{plans_pk}/subscribers/{id}/
Autenticação: JWT Bearer ou chave de API do vendedor.
Retorna um assinante do plano informado, com um bloco metrics adicional contendo a contagem de pagamentos (total / pagos / pendentes / atrasados / falhos). As métricas são calculadas apenas na ação de detalhe.

​
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.

​
Parâmetros de rota

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

​
Resposta

​
id
string
UUID do assinante.
​
subscription_plan
string
UUID do plano pai.
​
name
string
Nome completo.
​
email
string
E-mail do assinante.
​
taxpayer_id
string
CPF ou CNPJ.
​
status
string
Um dos valores pending (pendente), paid (pago), failed (falhou), overdue (atrasado), canceled (cancelado).
​
next_billing_date
string
Data/hora ISO 8601 da próxima cobrança agendada.
​
last_payment_date
string
Data/hora ISO 8601 do pagamento confirmado mais recente, ou null.
​
subscribed_at
string
Data/hora ISO 8601 em que o assinante foi criado.
​
canceled_at
string
Data/hora ISO 8601 em que o assinante foi cancelado, ou null.
​
metrics
object
Métricas de pagamento calculadas dinamicamente:
  • total_payments — total de pagamentos do assinante.
  • paid_payments — pagamentos com payment_status='paid'.
  • pending_payments — pagamentos com payment_status='pending'.
  • overdue_payments — pagamentos cujo due_date já passou e ainda não foram pagos.
  • failed_payments — pagamentos com payment_status='failed'.
{
  "id": "f4b1c7a9-8c2d-4d4f-9c3a-5e6f7a8b9c0d",
  "subscription_plan": "8b0e9f4a-2b7d-4f3f-9d8a-1c2e3a4b5c6d",
  "name": "Maria Souza",
  "email": "maria@example.com",
  "taxpayer_id": "12345678901",
  "status": "paid",
  "next_billing_date": "2026-06-14T12:30:00-03:00",
  "last_payment_date": "2026-05-14T12:30:04-03:00",
  "subscribed_at": "2026-05-14T12:30:00-03:00",
  "canceled_at": null,
  "metrics": {
    "total_payments": 4,
    "paid_payments": 4,
    "pending_payments": 0,
    "overdue_payments": 0,
    "failed_payments": 0
  }
}

​
Erros

StatusQuando
401Token ausente ou inválido.
403O chamador não está vinculado a este vendedor.
404O assinante não existe ou não pertence a este plano/vendedor.

​
Exemplos

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