Endpoint: GET /subscriptions/seller/{seller_id}/plans/
Autenticação: JWT bearer ou chave de API
Lista todos os planos de assinatura cuja account é a conta do vendedor identificada por seller_id, do mais recente para o mais antigo. Cada linha vem anotada com contagens de assinantes, para que o painel possa exibir a saúde do plano em um único olhar.

​
Pré-requisitos

  • Quem chama precisa estar autenticado contra o vendedor, seja por um JWT emitido em /user/login/ (com um vínculo de acesso entre usuário e vendedor) ou por uma chave de API com escopo de vendedor.

​
Parâmetros de rota

​
seller_id
string
required
UUID unificado da conta do vendedor dona dos planos.

​
Parâmetros de query

​
search
string
Busca de subsequência sem distinção de maiúsculas/minúsculas em name e description do plano.

​
Resposta

Retorna um array de objetos de plano, ordenados por created_at decrescente.
​
id
string
UUID do plano.
​
name
string
Nome do plano.
​
description
string
Descrição longa.
​
amount
string
Valor recorrente em centavos de BRL (armazenado como string).
​
payment_methods
array
Métodos de pagamento permitidos (credit_card, boleto, pix).
​
payment_methods_no_tax
array
Subconjunto de payment_methods em que o vendedor absorve a taxa.
​
end_date
string
Timestamp ISO-8601 em que a cobrança para, ou null.
​
frequency
string
Um dos valores weekly, biweekly, monthly, bimonthly, quarterly, semiannual, annual.
​
is_perpetual
boolean
true quando end_date é null.
​
total_subscribers
integer
Total de assinantes vinculados a este plano (qualquer status).
​
active_subscribers
integer
Total de assinantes em status paid ou pending.
​
created_at
string
Timestamp ISO-8601 de criação do plano.
​
updated_at
string
Timestamp ISO-8601 da última atualização do plano.
[
  {
    "id": "8b0e9f4a-2b7d-4f3f-9d8a-1c2e3a4b5c6d",
    "name": "Clube do Café — Mensal",
    "description": "Receba um pacote de 250g por mês.",
    "amount": "4990",
    "payment_methods": ["credit_card", "pix"],
    "payment_methods_no_tax": ["pix"],
    "end_date": null,
    "frequency": "monthly",
    "is_perpetual": true,
    "total_subscribers": 128,
    "active_subscribers": 112,
    "created_at": "2026-01-04T10:00:00-03:00",
    "updated_at": "2026-05-01T09:21:00-03:00"
  }
]
Inconsistência conhecida do campo amount: o valor é exposto como string em centavos. Trate-o como string e converta antes de operar aritmeticamente.

​
Erros

StatusQuando
401Token ausente ou inválido.
403Chamador autenticado, mas sem vínculo com este vendedor.

​
Exemplos

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