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.
Dados necessários para uma assinatura
Produto descontinuado
A 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órios
O e-mail do cliente é uma informação obrigatória, uma vez que utilizamos ele para enviar e-mails de assinatura.
Antifraude
A 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 assinatura
Só é 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 plano
Lembre-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.