Cobrança cripto recorrente sem cartão guardado

Como uma renovação acontece de verdade

O ciclo inteiro é de envio, nunca de débito. Leia esta seção e você saberá exatamente o que o sistema faz, porque não há muito mais.

1. 01

   Um endereço permanente por assinante

   Ao criar a assinatura, o assinante recebe um endereço de depósito derivado da sua própria carteira, e ele não muda entre períodos. Ele pode salvá-lo, automatizar o envio a partir da carteira dele ou pagar manualmente a cada período. Você nunca pede credenciais nem armazena nenhuma.

2. 02

   Um relógio de período, não uma tentativa de cobrança

   Uma assinatura carrega o início e o fim do período atual. No fim dele nada é tentado: sem reprocessamento, sem régua de cobrança, sem cobrança recusada. O período simplesmente vence se nenhum pagamento chegar, e é um pagamento que o faz avançar.

3. 03

   O pagamento chega, a renovação é avaliada

   Quando o dinheiro chega a esse endereço, ele é avaliado conforme o estado da assinatura. Se o período tinha vencido ou estava em aberto, conta como renovação, e você recebe o status exato do valor — pago, pago a menos ou pago a mais — para que sua aplicação decida que acesso isso concede. Um pagamento que chega atrasado é avaliado como renovação na chegada, não descartado.

4. 04

   Uma assinatura nova começa sem acesso

   Assinaturas começam pendentes, não ativas. O acesso começa quando o primeiro pagamento é detectado, o que elimina qualquer janela em que alguém tenha uma assinatura ativa sem ter pago. Sua aplicação deve tratar «pendente» como «ainda sem direito».

O que acontece com o dinheiro que chega num período já pago

O crédito é contabilidade, não custódia. Os fundos já estão no seu próprio endereço; o saldo de crédito é um número contábil que descreve o que chegou, não um saldo que guardamos por você. Não há nada para sacar, porque não há nada guardado.

Os webhooks que sua aplicação recebe

O estado de uma assinatura só é útil se a sua aplicação ficar sabendo. Estes são os eventos publicados hoje, na ordem em que ocorrem ao longo de um período.

subscription.renewed

Um pagamento foi avaliado contra uma assinatura em aberto ou vencida. Traz o status do valor — pago, pago a menos ou pago a mais — junto com os valores e a sua própria referência do assinante, para a sua aplicação decidir o que liberar.

subscription.expiring_soon

O período atual vence dentro do prazo de aviso que você configurar. É o gancho para o seu próprio e-mail de lembrete, enviado antes de qualquer perda.

subscription.expired

O período venceu sem pagamento. Ninguém foi cobrado e nada foi tentado; a assinatura apenas deixou de estar em dia, e sua aplicação deve revogar o acesso.

subscription.credit_added

Um pagamento chegou a uma assinatura cujo período atual já estava totalmente pago, e foi registrado como crédito em vez de ser tratado como renovação.

Todo webhook de assinatura é assinado, entregue com novas tentativas e carrega a sua própria referência externa do assinante, para que o lado que recebe nunca precise adivinhar de quem se trata.

Como funciona o recorrente sem cartão guardado

Tudo isto decorre de não haver um meio de pagamento guardado. Desenhe em função disso e o modelo funciona.

• Você não pode cobrar um assinante. Não há meio de pagamento armazenado nem débito automático, então cada período exige que o assinante envie — que é exatamente por que nada pode ser cobrado sem ele.
• Um assinante que se esquece simplesmente deixa a assinatura expirar. O webhook de expiração próxima existe para que você possa lembrá-lo, mas cabe a você enviar o lembrete, e a decisão continua sendo dele.
• Um plano com preço em cripto acompanha o mercado de um período para o outro. Precifique em stablecoin se quiser que o valor signifique o mesmo no mês que vem.
• Não existe chargeback nem estorno. Reembolso é um pagamento que você devolve, nos seus próprios termos, a partir da sua própria carteira.
• Conceder e revogar acesso é trabalho da sua aplicação. A Unheld informa o que aconteceu e quando; ela não fica na frente do seu produto.

Perguntas