1. Planos
SYNC-DOCUMENTATION
  • Introdução
  • Auth Token
    • Gera o token de utilização da aplicação
      POST
  • Saldo
    • Retorna o Saldo do Usuário
      GET
  • Transações
    • Consultar transação V1
      GET
    • Consultar transação V2
      GET
  • Utmify
    • Salvar Token
      POST
    • Desativa Token
      POST
  • Partner
    • Consulta dados do Parceiro
      GET
  • Cartão de Crédito
    • Tokenização pública de cartão
    • IFrame
    • Cobrar no cartão
      POST
  • Pix - CashIn
    • Solicitação de depósito via Pix
      POST
  • Old API
    • CashIn
      POST
    • Consulta os dados do Parceiro
      GET
  • Assinaturas - Recorrência
    • Assinatura com Cartão de Crédito
    • Planos
      • Listar planos
      • Criar plano
      • Detalhe do plano
      • Assinantes do plano
    • Assinantes
      • Cadastrar assinante
      • Listar assinantes
      • Detalhe da assinatura
      • Cancelar assinatura
      • Pausar assinatura
      • Reativar assinatura
      • Trocar plano da assinatura
    • Notificações
      • Listar entregas de um webhook
    • Produtos — Planos
      • Listar planos aninhados a um produto
      • Criar plano aninhado a um produto
      • Marcar plano como padrão do produto
  • Reembolsos
    • Solicitar reembolso de uma venda
    • Consultar uma solicitação de reembolso
  • Webhooks
    • Cash-In
      • Cash-in criado (cobrança PIX gerada)
      • Cash-in atualizado (mudança de status)
      • Cash-in legado (notificação mínima)
    • Cash-Out
      • Cash-out criado (saque solicitado)
      • Cash-out atualizado (mudança de status do saque)
    • Cartão de Crédito
      • Cartão de crédito — cobrança criada
      • Cartão de crédito — mudança de status
    • Transações - Completo
      • Cobrança de transação criada
      • Transação teve mudança de status
    • Listar webhooks
    • Criar webhook
    • Atualizar webhook
    • Excluir webhook
    • Rotacionar o segredo de assinatura
  • Raiz
    • iFrame de pagamento (cartão e Apple Pay)
    • Planos
      • Catálogo do que pode ser cobrado
        GET
    • Assinantes
      • Cobranças da assinatura (e as próximas)
    • Notificações
      • Listar webhooks
      • Criar webhook
      • Atualizar webhook
      • Remover webhook
  • Esquemas
    • Webhook
      • CashIn
        • onCreate
        • onUpdate
        • CashinCreated
        • CashinUpdated
        • CashinOld
      • CashOut
        • onCreate
        • onUpdate
      • Cash-In
        • CashinCreated
        • CashinUpdated
        • CashinOld
    • CashinCreated
    • WebhookInput
    • CardTokenRequest
    • CreditCardPaymentRequest
    • Message
    • RefundReason
    • CreditCardCreated
    • Transaction
    • TransactionEvent
    • BillingMethod
    • CashoutCreated
    • CreditCardCreatePayload
    • RefundStatus
    • CreditCardPaymentAccepted
    • CardToken
    • CreditCardStatusPayload
    • CashinUpdated
    • Webhook
    • CashoutUpdated
    • CreditCardUpdated
    • TransactionV2
    • PlanStatus
    • RefundWebhookPayload
    • RefundRejectionCategory
    • CashinOld
    • Customer
    • CreatedWebhook
    • SplitStatus
    • WebhookListItem
    • DebtorAccount
    • SubscriptionSplit
    • PaymentMethod
    • RefundRequest
    • SimpleError
    • WebhookDelivery
    • SplitRecipientPayload
    • CodedError
    • Payment
    • RotatedWebhookSecret
    • StoreProductPlanRequest
    • PlanResource
    • SubscriptionSplitInvite
    • RefundTransaction
    • Card
    • Checkout
    • UpdateProductPlanRequest
    • RefundEvent
    • RefusedError
    • PlanContext
    • SubscriptionStatus
    • PaymentLink
    • AntiFraudError
    • ChargeStatus
    • PaymentStatus
    • Error
    • SubscriptionSplitItem
    • Tracking
    • ChargeAttemptResource
    • DeliveryAddress
    • UpcomingCharges
    • EnrollTargetRejected
    • PaginationMeta
    • CatalogPlan
    • ProblemJson
    • ChargeResource
    • SubscriptionResource
    • WebhookResource
    • NotFoundError
    • ValidationError
    • EnrollPaymentQrCode
    • EnrollPaymentPixAutomatico
    • ChargeBlock
    • EnrollPaymentCreditCard
    • WebhookDeliveryResource
    • WebhookEnvelope
    • MandateBlock
  1. Planos

Catálogo do que pode ser cobrado

GET
/api/partner/v1/subscription-products
Lista os produtos de assinatura à venda, com os planos de cada um, e a
sua integração via API em meta.integration. Escopo plans:read.
billing_methods dentro de cada plano é exatamente o que a adesão
aceita naquele lugar
; default_billing_method do plano é a forma
usada quando a adesão ali não informa billing_method (null = é
preciso informar).
Um plano pode aparecer dentro de um produto e em
meta.integration
, com listas diferentes: a do produto vale para
adesão com product; a de meta.integration, para adesão sem product.
Plano criado dentro de um produto à venda (vínculo ativo) só aparece
no produto. Com o produto pausado, arquivado ou apagado, ou o vínculo
inativo, ele passa para meta.integration.
billing_methods no topo do produto e em meta.integration é a
união das listas dos planos (resumo). default_billing_method
no topo do produto é o padrão configurado no produto.
meta.integration aparece igual em todas as páginas e traz no
máximo 200 planos (do mais antigo para o mais novo). Acima
disso, plans_truncated: true; os planos fora da lista continuam
aceitando adesão pelo token.
credit_card só aparece com as liberações de cartão da conta.

Requisição

Authorization
Bearer Token
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
or
Parâmetros de Consulta

Respostas

🟢200
application/json
Catálogo paginado.
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/partner/v1/subscription-products?per_page=&page=' \
--header 'Authorization: Bearer <token>'
Response Response Example
{
    "data": [
        {
            "reference_id": "5e0c1a2b-0000-4000-8000-00000000a501",
            "name": "Clinix Agenda",
            "billing_methods": [
                "qr_code",
                "pix_automatico"
            ],
            "default_billing_method": "qr_code",
            "plans": [
                {
                    "token": "9d1f0000-0000-4000-8000-00000000c001",
                    "name": "Clinix Mensal",
                    "amount": "97.00",
                    "periodicity_days": 30,
                    "billing_methods": [
                        "qr_code",
                        "pix_automatico"
                    ],
                    "default_billing_method": "qr_code"
                },
                {
                    "token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                    "name": "Studio Nuvem Mensal",
                    "amount": "49.90",
                    "periodicity_days": 30,
                    "billing_methods": [
                        "qr_code"
                    ],
                    "default_billing_method": "qr_code"
                }
            ]
        }
    ],
    "meta": {
        "integration": {
            "billing_methods": [
                "qr_code",
                "pix_automatico",
                "credit_card"
            ],
            "plans": [
                {
                    "token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                    "name": "Studio Nuvem Mensal",
                    "amount": "49.90",
                    "periodicity_days": 30,
                    "billing_methods": [
                        "pix_automatico",
                        "credit_card"
                    ],
                    "default_billing_method": "pix_automatico"
                },
                {
                    "token": "b2c3d4e5-0000-4000-8000-00000000a002",
                    "name": "Studio Nuvem Plus",
                    "amount": "39.90",
                    "periodicity_days": 30,
                    "billing_methods": [
                        "qr_code",
                        "pix_automatico"
                    ],
                    "default_billing_method": "qr_code"
                }
            ],
            "plans_truncated": false
        },
        "total": 1,
        "current_page": 1,
        "per_page": 15,
        "last_page": 1
    }
}
Modificado em 2026-10-30 00:52:45
Página anterior
iFrame de pagamento (cartão e Apple Pay)
Próxima página
Cobranças da assinatura (e as próximas)
Built with