Checkout Skill: Subscription

Visão geral

Integra checkouts de assinatura (subscription) com a Pagar.me. O fluxo básico envolve: criar um plano → gerar checkout com plan_id → cliente acessa URL e se cadastra → Pagar.me cobra automaticamente conforme o ciclo.

Requisitos principais

• Conta Pagar.me ativa com secret key (sk_...)
• Ambiente de teste ou produção configurado
• Plano obrigatório — não há checkout de assinatura sem plano prévio
• Sem parcelamento, split ou Pix para recorrências

Arquitetura em duas etapas

Passo 1 — criar plano via POST /plans com nome, intervalo, tipo de cobrança e itens com preço em centavos.

Passo 2 — gerar checkout via POST /paymentlinks definindo type: "subscription" e referenciando o plan_id.

Configurações avançadas

Controle de matrículas e janelas de venda através de max_paid_sessions, expires_in/expires_at e is_building — útil para infoprodutos e turmas com vagas limitadas.

Meios de pagamento suportados

Cartão de crédito (recomendado) e boleto. Pix não está disponível para recorrência.

Webhooks relevantes

• subscription.created
• charge.paid
• charge.payment_failed
• subscription.canceled
• subscription.expired
• charge.refunded

Jornada: Vender com link de pagamento
Etapa 5 de 8