Importante: Todos os valores na API são representados em centavos.Exemplo: R$ 100,00 =
10000O que são Assinaturas?
Assinaturas são cobranças recorrentes automáticas que permitem você cobrar seus clientes de forma periódica (semanal, mensal, trimestral, etc.) sem precisar criar uma nova transação manualmente a cada ciclo.Cobranças Automáticas
Cobranças processadas automaticamente no ciclo definido
Múltiplos Ciclos
Semanal, quinzenal, mensal, trimestral, semestral ou anual
Período de Trial
Ofereça períodos de teste gratuitos de até 90 dias
Métricas SaaS
MRR, ARR, Churn Rate e outras métricas em tempo real
Ciclos de Cobrança Disponíveis
Status de Assinatura
As assinaturas podem ter os seguintes status:Fluxo de uma Assinatura
1
Criar Transação com Assinatura
Você cria uma transação via API incluindo o bloco
subscription com enabled: true2
Aguardar Pagamento
A assinatura é criada com status
PENDING aguardando o primeiro pagamento3
Ativação
Após confirmação do pagamento, a assinatura muda para
ACTIVE (ou TRIALING se houver trial)4
Cobranças Recorrentes
O sistema processa automaticamente as cobranças no ciclo definido
5
Notificações
Você recebe webhooks sobre mudanças de status e cobranças
Métodos de Pagamento Suportados
PIX
Pagamento recorrente via PIX
Cartão de Crédito
Cobrança automática no cartão tokenizado
Período de Trial
Você pode oferecer um período de teste gratuito para seus clientes:- Mínimo: 0 dias (sem trial)
- Máximo: 90 dias
- Durante o trial, a assinatura fica com status
TRIALING - A primeira cobrança ocorre após o término do período de trial
- O cliente pode cancelar durante o trial sem ser cobrado