Listar pagamentos da assinatura

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

string

required

UUID da conta unificada do vendedor.

string

required

UUID do plano de assinatura pai.

string

required

UUID do assinante pai.

Resposta

Array de pagamentos da assinatura, do mais recente para o mais antigo.

string

UUID do pagamento.

string

UUID do assinante pai.

string

UUID do plano pai.

string

UUID da transação unificada vinculada, ou null quando a cobrança ainda não foi tentada.

string

Valor do pagamento em centavos de BRL (string).

string

Um dos valores credit_card, boleto, pix.

string

Um dos valores pending (pendente), paid (pago), failed (falhou), overdue (atrasado), canceled (cancelado).

string

Data/hora de vencimento do pagamento no formato ISO 8601.

string

Data/hora de confirmação do pagamento em ISO 8601, ou null.

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

Status	Quando
`401`	Token ausente ou inválido.
`403`	O chamador não está vinculado a este vendedor.
`404`	O 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"

import requests

response = requests.get(
    f"https://api.dlpay.cloud/subscriptions/seller/{seller_id}"
    f"/plans/{plan_id}/subscribers/{subscriber_id}/payments/",
    headers={"Authorization": f"Bearer {access_token}"},
)
payments = response.json()

const response = await fetch(
  `https://api.dlpay.cloud/subscriptions/seller/${sellerId}` +
    `/plans/${planId}/subscribers/${subscriberId}/payments/`,
  { headers: { Authorization: `Bearer ${accessToken}` } },
);
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 da assinatura

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