dunas

Ir para produção

O que conferir antes de cobrar clientes de verdade.

Troque as chaves

Use as chaves de produção de cada provedor e tire sandbox: true da Woovi.

Registre os webhooks

Depois do deploy, com o servidor respondendo:

await billing.registerWebhooks({ baseUrl: "https://seuapp.com" })

A Woovi chama a URL na hora de registrar e recusa se ela não responder. Rodar de novo não duplica nada, então pode fazer parte do seu script de deploy.

Agende as renovações

Chame a rota de renovações uma vez por hora com o CRON_SECRET:

vercel.json
{
  "crons": [{ "path": "/api/dunas/renewals", "schedule": "0 * * * *" }]
}

Defina CRON_SECRET nas variáveis do projeto. A Vercel envia o header de autorização sozinha.

Avise o cliente

Na renovação por Pix, o dunas cria a cobrança, mas quem manda para o cliente é você. Com Pix Automático ou cartão não há cobrança para mandar, e subscription.method_changed avisa quando a assinatura volta para Pix. Use os eventos:

on: {
  "charge.created": ({ charge }) => sendPaymentEmail(charge),
  "subscription.past_due": ({ subscription }) => sendReminder(subscription),
}

Mande os dados de quem paga

Os provedores pedem dados do pagador. Chame upsertCustomer com nome, e-mail, CPF ou CNPJ e celular assim que tiver. Veja o que cada provedor exige em Provedores.

Rode as migrações no deploy

billing.migrate() pode rodar a cada deploy. Novas versões do dunas podem trazer tabelas ou colunas novas.

Nesta página