Pagamentos — Recorrência

Pagamentos

Recorrência

Do SaaS ao clube de assinaturas: a plataforma cuida do ciclo inteiro de recorrência — emissão, cobrança, tentativa e cancelamento — em cartão, boleto e Pix.

Como funciona

A assinatura (subscription) nasce de um blueprint de cobrança. Uma vez ativa, o sistema dispara novas cobranças de acordo com o ciclo definido até ser cancelada.

  • Ciclos: semanal, quinzenal, mensal, trimestral, semestral e anual.
  • Meios: cartão de crédito, boleto e Pix.
  • Cancelamento pontual via API: interrompe o ciclo sem afetar cobranças já pagas.
  • Retentativas e novas emissões seguem as regras do provedor de cartão.

Criar uma assinatura

POST /api/v1/bank/wallet/subscription/

{
  "wallet_uuid": "<wallet>",
  "type": "credit_card",
  "cycle": "monthly",
  "amount_in_cents": 2990,
  "merchant": { "name": "Plataforma Pro" }
}

Cancelar uma assinatura

POST /api/v1/bank/wallet/subscription/<uuid>/cancel/<wallet_uuid>/