Pular para o conteúdo principal

Assinaturas e cobrança recorrente

Agendam cobranças automáticas em cartão de crédito com periodicidade configurável. A YumePay controla o calendário — ele não é delegado ao adquirente.

ObjetoO que é
SubscriptionO agendamento recorrente: pagador, valor, ciclo e cartão tokenizado
ChargeCada cobrança gerada a cada vencimento. Uma assinatura gera N cobranças
  • O cartão é tokenizado na criação. Os dados completos não são armazenados e o token do adquirente nunca é exposto pela API.
  • Cobranças são processadas automaticamente pelo processamento periódico de vencimentos (Processamento das cobranças).
  • Cada cobrança é única por assinatura e data — reprocessar não duplica. Uma retentativa (Retentativa de cobrança negada) reprocessa a mesma cobrança.
CaminhoSituaçãoResultado
A · Criar assinatura com cartãoVocê já tem o cartãoA assinatura nasce ACTIVE
B · Criar assinatura sem cartão e Ativar a assinatura pelo seu próprio checkoutO pagador informa o cartãoA assinatura nasce PENDING_PAYMENT e você recebe uma URL de checkout