Para efetivamente cobrar seu cliente de forma recorrente, você deve criar uma assinatura atrelada a um plano, que então conterá os dados de cobrança.
A criação de uma subscription (assinatura) é parecida com a criação de uma transação. Se for uma assinatura paga com Cartão de crédito, é possível usar um card_id, card_hash ou todos os dados do cartão. Para pagamento por Boleto bancário, você precisa especificar apenas o payment_method.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Atenção: Essa versão de API será descontinuadaEssa versão da API Pagar.me já não é mais atualizada e, em breve, deixará de funcionar. Para que sua loja possa vender sem problemas, você precisa realizar sua integração usando a versão mais recente da nossa API, a V5.
No canto superior esquerdo da tela é indicado qual versão da documentação você está vendo. Clique na seta onde indica a versão e altere para a V5 para acessar a documentação.
Se você já é cliente, precisa realizar obrigatoriamente a migração para a versão V5.
Em caso de dúvidas, basta entrar em contato com o nosso time de atendimento através do e-mail, enviando a sua dúvida para [email protected] e por telefone, ligando para 4004-1330. Se você já é cliente pode também entrar em contato através do chat dentro da sua Dashboard.
Dados necessários para uma assinatura
Produto descontinuadoA Pagar.me não permite nova integrações na API de recorrência v4 (esta página). Para nova integrações do produto de recorrência, utilizar a API v5.
Dados obrigatóriosO e-mail do cliente é uma informação obrigatória, uma vez que utilizamos ele para enviar e-mails de assinatura.
AntifraudeA primeira transação criada em uma assinatura passa por antifraude, logo, é obrigatório enviar todos os dados de customer.
Valores de uma assinatura
Dando descontos na assinaturaSó é possível dar descontos na assinatura através de troca para um plano mais barato, mas vale ressaltar que isso gera uma nova periodicidade. Mais em: Fluxo de cobrança.
Observações
ID do planoLembre-se de passar o ID de seu plano em todas as requests, para que não seja necessário recriar todas assinaturas que ficaram com plan_id = null.