Endpoint: GET /subscriptions/subscriber/{subscriber_id}/payment/
Autenticação: Público (sem autenticação)
Lista os pagamentos pertencentes a um assinante. Como o UUID do assinante é não-adivinhável, este endpoint é exposto publicamente para suportar páginas de autoatendimento, onde o assinante consulta seu histórico de cobranças.

​
Pré-requisitos

  • O assinante precisa existir. Assinantes são criados por POST /subscriptions/plan/{plan_id}/subscribe/ ou pelo vendedor via API autenticada.

​
Parâmetros de rota

​
subscriber_id
string
required
UUID do assinante.

​
Resposta

Array de objetos públicos de pagamento, do mais recente para o mais antigo.
​
id
string
UUID do pagamento.
​
amount
string
Centavos de BRL como string (espelha o amount do plano no momento em que o pagamento foi agendado).
​
payment_method
string
Um dos valores credit_card, boleto, pix.
​
payment_status
string
Um dos valores pending, paid, failed, overdue, canceled.
​
due_date
string
Timestamp ISO-8601 do vencimento do pagamento.
​
paid_at
string
Timestamp ISO-8601 em que o pagamento foi confirmado como pago, ou null.
​
created_at
string
Timestamp ISO-8601 em que o pagamento foi criado.
​
plan_name
string
Cópia por conveniência do nome do plano de assinatura.
​
plan_frequency
string
Cópia por conveniência da frequência do plano (monthly, etc.).
​
subscriber_name
string
Cópia por conveniência do nome do assinante.
[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef0123456789",
    "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",
    "plan_name": "Clube do Café — Mensal",
    "plan_frequency": "monthly",
    "subscriber_name": "Maria Souza"
  }
]
Inconsistência conhecida do campo amount: o valor é retornado como string em centavos (ex.: "4990" = R$ 49,90), diferente da convenção em centavos inteiros adotada em outros endpoints.

​
Erros

StatusQuando
404O assinante não existe. O endpoint retorna lista vazia quando o assinante existe mas não tem pagamentos.

​
Exemplos

curl https://api.dlpay.cloud/subscriptions/subscriber/f4b1c7a9-8c2d-4d4f-9c3a-5e6f7a8b9c0d/payment/