Um ciclo pode ser cobrado duas vezes?

Não. O banco impede duas faturas para o mesmo ciclo, e as duas etapas do worker são idempotentes. Se o processo rodar de novo depois de uma falha, ele encontra a fatura que já existe em vez de criar outra.

O que acontece quando o emissor cancela a recorrência?

A assinatura é cancelada e marcada como cancelada pelo emissor, e um evento avisa seu sistema. Essa assinatura não pode ser reativada com o mesmo cartão: é preciso criar uma nova com outro meio de pagamento.

Dá para testar o ciclo inteiro antes de ir ao ar?

Dá. No sandbox, cada cartão de teste tem um resultado fixo: aprova, recusa por saldo, cartão perdido, suspensão de recorrência ou exigência de 3DS. Dá para ver a recuperação e o cancelamento pelo emissor acontecendo de ponta a ponta.

Assinaturas

Assinaturas que se cobram sozinhas e se recuperam

Você cadastra o preço e o ritmo uma vez. O Minstrel gera a fatura de cada ciclo, cobra, retenta quando faz sentido, lida com troca de cartão, pausa e cancelamento, e devolve MRR, churn e faturas em aberto.

Fatura por ciclo, nunca duplicada
Proporcional a favor do cliente
MRR e churn prontos

Testar no sandbox Documentação de assinaturas

Como funciona

1
Crie o plano
Preço, intervalo, dias de teste e o dia de cobrança. Dá para cobrar na adesão ou ao fim do período.
2
Assine o cliente
A primeira cobrança vai como transação iniciada pelo cliente, que é o que o emissor espera no começo de uma recorrência.
3
O ciclo roda sozinho
Um worker gera a fatura na antecedência do plano e outro vira o período. Cada ciclo é faturado uma única vez.
4
A recusa vira recuperação
A fatura segue a política de retentativa, a régua avisa o cliente e a troca de cartão recoloca as faturas vencidas na fila na hora.

No painel

A assinatura

Status do ciclo, próxima fatura com data e valor, meio de pagamento e o histórico de faturas. A troca de cartão e a baixa manual ficam aqui.

Assinatura ativa, com a próxima fatura já calculada e o histórico de ciclos.

No painel

A recuperação

Uma fatura recusada entra em atraso, agenda a próxima tentativa pela política e dispara a régua, que leva o link para o cliente pagar ou trocar o cartão.

Fatura em atraso: tentativa agendada pela política e aviso enviado ao cliente.

O que está incluído

Plano, assinatura e fatura são coisas separadas
O plano é o preço e o ritmo, a assinatura é o contrato do cliente e a fatura é a intenção de cobrar um ciclo. É a fatura que é cobrada, retentada e avisada pela régua, nunca a assinatura direto.
Cobre na adesão ou pelo que foi usado
No pré-pago a assinatura só fica ativa quando a primeira fatura é paga, porque ativar antes daria acesso a quem não pagou. Um evento marca o momento exato de liberar o acesso.
billingTiming: "start" | "end"
O proporcional é arredondado a favor do cliente
Quem assina no dia 25 num plano que cobra dia 10 paga pelos dias que usou, e o item da fatura mostra a conta: ciclo proporcional, 16 de 31 dias. Vale também para a retomada de uma assinatura pausada.
Trocar o cartão recoloca as faturas na fila
A resposta diz quantas faturas voltaram para a fila. Mas trocar o cartão não quita a dívida: o status muda quando a cobrança for aprovada.
Pausar não cobra o período sem acesso
A pausa cancela as faturas de períodos que ainda não começaram, e a retomada abre um ciclo novo a partir de agora, em vez de cobrar o tempo em que o cliente ficou sem acesso.
Dinheiro que entrou por fora tem baixa manual
A fatura fica paga fora da plataforma, a assinatura reativa e o link de pagamento ativo é cancelado na hora, para o cliente não pagar duas vezes a mesma fatura.
POST /v1/invoices/:id/mark-paid
MRR, churn e carteira em um endpoint
MRR e ARR, ticket médio, churn de 30 dias, assinaturas por status e faturas em aberto, vencidas, a vencer em sete dias e pagas no mês. O MRR conta as assinaturas ativas e as em atraso, pelo valor negociado de cada uma.
GET /v1/billing/summary

Criar um plano

POST /v1/plans{  "productId": "prod_01HQ...",  "name": "Mensal",  "amount": 14990,  "interval": "month",  "billingTiming": "start",  "trialDays": 7,  "invoiceLeadDays": 3}

Documentação de assinaturas

Régua de cobrança

Os modelos de mensagem e o agendamento por evento da fatura já existem no painel, e a variável com o link da fatura sai preenchida. O envio por e-mail está em implantação, e o WhatsApp vem depois dele. Enquanto isso, os eventos de fatura saem por webhook e você dispara pelo canal que já usa.

Dúvidas frequentes

O detalhe técnico de cada resposta está na documentação de assinaturas.

Um ciclo pode ser cobrado duas vezes?
Não. O banco impede duas faturas para o mesmo ciclo, e as duas etapas do worker são idempotentes. Se o processo rodar de novo depois de uma falha, ele encontra a fatura que já existe em vez de criar outra.
O que acontece quando o emissor cancela a recorrência?
A assinatura é cancelada e marcada como cancelada pelo emissor, e um evento avisa seu sistema. Essa assinatura não pode ser reativada com o mesmo cartão: é preciso criar uma nova com outro meio de pagamento.
Dá para testar o ciclo inteiro antes de ir ao ar?
Dá. No sandbox, cada cartão de teste tem um resultado fixo: aprova, recusa por saldo, cartão perdido, suspensão de recorrência ou exigência de 3DS. Dá para ver a recuperação e o cancelamento pelo emissor acontecendo de ponta a ponta.

Continua em

Veja funcionando no sandbox

Gratuito, ilimitado e sem prazo. Dá para simular aprovação, cada recusa da ABECS e falha de rede antes de credenciar a primeira adquirente.

Primeiros passos Ver preços