Listar pagamentos do assinante (público)

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

string

required

UUID do assinante.

Resposta

Array de objetos públicos de pagamento, do mais recente para o mais antigo.

string

UUID do pagamento.

string

Centavos de BRL como string (espelha o amount do plano no momento em que o pagamento foi agendado).

string

Um dos valores credit_card, boleto, pix.

string

Um dos valores pending, paid, failed, overdue, canceled.

string

Timestamp ISO-8601 do vencimento do pagamento.

string

Timestamp ISO-8601 em que o pagamento foi confirmado como pago, ou null.

string

Timestamp ISO-8601 em que o pagamento foi criado.

string

Cópia por conveniência do nome do plano de assinatura.

string

Cópia por conveniência da frequência do plano (monthly, etc.).

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

Status	Quando
`404`	O 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/

import requests

response = requests.get(
    "https://api.dlpay.cloud/subscriptions/subscriber/f4b1c7a9-8c2d-4d4f-9c3a-5e6f7a8b9c0d/payment/",
)
payments = response.json()

const response = await fetch(
  "https://api.dlpay.cloud/subscriptions/subscriber/f4b1c7a9-8c2d-4d4f-9c3a-5e6f7a8b9c0d/payment/",
);
const payments = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Listar pagamentos do assinante (público)

Pré-requisitos

Parâmetros de rota

Resposta

Erros

Exemplos

​Pré-requisitos

​Parâmetros de rota

​Resposta

​Erros

​Exemplos

Pré-requisitos

Parâmetros de rota

Resposta

Erros

Exemplos