---
title: "Checkout Skill: Subscription (legado)"
url: "https://devcenter.stone.com.br/legacy-checkout-skill-subscription"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_~Q2hlY2tvdXQgU2tpbGw6IFN1YnNjcmlwdGlvbiAobGVnYWRvKQ,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9sZWdhY3ktY2hlY2tvdXQtc2tpbGwtc3Vic2NyaXB0aW9uIg,s_lXJbOTlHOj2nUA4R.png"
---

# Checkout Skill: Subscription

Skill IA para criar checkouts de assinatura via Pagar.me — referência rápida da integração.

Documentação legada do Pagar.me v5

Esta página descreve um conceito da **Pagar.me v5** (versão clássica). Para projetos novos, explore o **[API Catalog](https://devcenter.stone.com.br/catalog)**.

## [Visão geral](#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](#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](#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](#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](#meios-de-pagamento-suportados)

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

## [Webhooks relevantes](#webhooks-relevantes)

-   `subscription.created`
-   `charge.paid`
-   `charge.payment_failed`
-   `subscription.canceled`
-   `subscription.expired`
-   `charge.refunded`

---

**Jornada: [Vender com link de pagamento](https://devcenter.stone.com.br/legacy-checkout-pagarme)**  
Etapa 5 de 8

[**Etapa anterior**Checkout: Skill para IA](https://devcenter.stone.com.br/legacy-checkout-skill)[**Próxima etapa**Shop: Overview](https://devcenter.stone.com.br/legacy-overview-shop)

Siga a Stone nas redes sociais

[](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ)

© Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57

Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP

Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.