Provedores

O provedor é quem cobra de verdade. O dunas fala com cada um do jeito dele e entrega a mesma resposta para o seu código, então trocar ou adicionar um provedor é uma linha na configuração.

WooviCopy Anchor Link

woovi({ appId: process.env.WOOVI_APP_ID, sandbox: true })

sandbox: true usa o ambiente de testes. Se você configurar um header de autorização nos webhooks da Woovi, passe o mesmo valor em webhookAuthorization.

AbacatePayCopy Anchor Link

abacatepay({
  apiKey: process.env.ABACATEPAY_API_KEY,
  webhookSecret: process.env.ABACATEPAY_WEBHOOK_SECRET,
})

O modo de desenvolvimento vem da própria chave.

Formas de pagamentoCopy Anchor Link

Pix vem ligado em todos os provedores. As outras formas você liga em methods, só com o que a sua conta tem:

woovi({ appId: process.env.WOOVI_APP_ID, methods: ["pix_automatico"] })

abacatepay({
  apiKey: process.env.ABACATEPAY_API_KEY,
  webhookSecret: process.env.ABACATEPAY_WEBHOOK_SECRET,
  methods: ["card", "pix_automatico"],
})

hosted manda o cliente para a página do provedor. embedded devolve o Pix para você mostrar no seu app. O TypeScript acompanha essa tabela: subscribe só aceita a forma e o checkout que algum provedor ligou.

• Na Woovi, Pix Automático pede o nome e o CPF ou CNPJ do cliente.
• Na AbacatePay, Pix Automático precisa ser habilitado na loja pelo suporte.
• Uma assinatura com Pix Automático ou cartão fica no provedor que a criou. O roteamento só escolhe na hora de assinar.

RoteamentoCopy Anchor Link

Com mais de um provedor, routing escolhe qual cria cada cobrança, entre os que oferecem a forma de pagamento pedida.

routing: ({ amountInCents }) => (amountInCents > 50_000 ? "woovi" : "abacatepay")

A função também pode devolver uma lista, que vira a ordem de tentativa.

WebhooksCopy Anchor Link

Os provedores avisam o seu app quando uma cobrança muda. Registre os webhooks uma vez, com o servidor já no ar:

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

Registrar de novo não duplica nada. E o dunas trata cada aviso só como um sinal: ele confere a assinatura e relê a cobrança no provedor antes de liberar qualquer acesso.

Dados do clienteCopy Anchor Link

Os provedores pedem dados de quem paga. Mande o que você tiver com upsertCustomer. A AbacatePay recebe o pagador quando há nome, e-mail, CPF ou CNPJ e celular. A Woovi, quando há nome e pelo menos um desses três.