Buscar pagamento da assinatura

Endpoint: GET /subscriptions/seller/{seller_id}/plans/{plans_pk}/subscribers/{subscribers_pk}/payments/{id}/

Autenticação: JWT Bearer ou chave de API do vendedor.

Retorna um único pagamento de assinatura pelo seu UUID. A estrutura da resposta é a mesma do endpoint de listagem. O campo transaction liga este pagamento à transação unificada que sustenta a cobrança — siga essa referência via API unificada para inspecionar status financeiro, splits e recebíveis associados.

Pré-requisitos

O chamador precisa estar autenticado contra o vendedor identificado por seller_id.
O pagamento deve pertencer ao assinante identificado por subscribers_pk. A consulta é restrita por subscriber=subscribers_pk, então pagamentos de outro assinante retornarão 404, mesmo que o UUID seja válido em outro contexto.

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.

string

required

UUID do pagamento da assinatura.

Resposta

Mesma estrutura do endpoint de listagem, retornando um único objeto.

{
  "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 pagamento não existe ou não pertence a este assinante.

Exemplos

curl https://api.dlpay.cloud/subscriptions/seller/SELLER_ID/plans/PLAN_ID/subscribers/SUBSCRIBER_ID/payments/PAYMENT_ID/ \
  -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/{payment_id}/",
    headers={"Authorization": f"Bearer {access_token}"},
)
payment = response.json()

const response = await fetch(
  `https://api.dlpay.cloud/subscriptions/seller/${sellerId}` +
    `/plans/${planId}/subscribers/${subscriberId}/payments/${paymentId}/`,
  { headers: { Authorization: `Bearer ${accessToken}` } },
);
const payment = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Buscar pagamento 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