Pagar.me Checkout

Página de pagamento hospedada nos servidores Pagar.me. O merchant envia os dados da venda via API, recebe uma URL e redireciona o comprador — sem formulário próprio, sem lidar com dados de cartão diretamente.

Pagar.me é a principal API de pagamentos do Brasil. O Checkout oferece dois modelos de cobrança, ambos criados via o mesmo endpoint POST /paymentlinks, diferenciados pelo campo type.

Funcionamento geral

Cobrança pontual (order):

Merchant → POST /paymentlinks → recebe URL → redireciona comprador

Cobrança recorrente (subscription):

Merchant → POST /plans → POST /paymentlinks → recebe URL → redireciona comprador

• Credencial: secret key (sk_...) via HTTP Basic Auth
• Header obrigatório em toda requisição: User-Agent: pagarme-skill-generated/1.0
• Valores sempre em centavos: R$100,00 = 10000

Ambientes

Modelos de cobrança

Cobrança Pontual (type: "order")

Transação única. O cliente acessa a URL, paga e o checkout é encerrado.

Indicado para:

• E-commerce e lojas virtuais
• Vendas avulsas e links de pagamento ad hoc
• Qualquer cobrança que acontece uma única vez

Meios disponíveis: cartão de crédito, Pix, boleto.

SKILL técnica: https://docs.pagar.me/docs/checkout_pagarme_skill_order.md

Cobrança Recorrente (type: "subscription")

O cliente se cadastra via checkout e passa a ser cobrado automaticamente no ciclo definido pelo plano.

Indicado para:

• Assinaturas e planos mensais
• Mensalidades e anuidades
• Qualquer cobrança que se repete no tempo

Meios disponíveis: cartão de crédito, boleto. Não disponível: Pix, parcelamento, split.

⚠️

Requer plano criado previamente via POST /plans.

O plan_id retornado deve ser usado em cart_settings.recurrences[].plan_id.

Fluxo:

1. POST /plans          → retorna plan.id
2. POST /paymentlinks   → usa plan.id em cart_settings.recurrences[]

SKILL técnica: https://docs.pagar.me/docs/checkout_pagarme_skill_subscription.md

Referências

• Sobre o Checkout: https://docs.pagar.me/docs/checkout-about
• Como usar: https://docs.pagar.me/docs/checkout-use
• Criar link — endpoint e parâmetros: https://docs.pagar.me/reference/criar-link.md
• Parâmetros do link: https://docs.pagar.me/reference/checkout-link.md
• Schema da resposta: https://docs.pagar.me/reference/checkout-response.md
• Criar plano — endpoint e parâmetros: https://docs.pagar.me/reference/criar-plano-1.md
• Visão geral de recorrência: https://docs.pagar.me/docs/overview-recorrência