Billing de SaaS no WordPress: escolhendo entre Polar, WooCommerce e outros provedores

O billing é onde um SaaS no WordPress deixa de ser uma demonstração e começa a ser um negócio. Em um Website-as-a-Service (WaaS) construído com o GrabWP Tenancy, um visitante se cadastra, paga e recebe um site tenant provisionado sem que você precise tocar em nada. A questão não é se você precisa de billing, e sim qual provedor se adapta ao seu mercado. Este guia mostra o que o billing precisa fazer, e depois compara o Polar.sh, o WooCommerce e os adaptadores regionais, para que você possa escolher sem ficar preso a uma única opção.

O que o billing precisa fazer em um WaaS de autoatendimento

O fluxo principal é curto para descrever e implacável se der errado: cadastro, pagamento, provisionamento. Um cliente em potencial escolhe um plano, conclui o pagamento e o sistema cria seu site tenant isolado automaticamente. Sem passos manuais, sem ticket de suporte, sem espera.

Para que isso seja confiável, três coisas precisam ser garantidas. Primeiro, o provisionamento deve ser idempotente. O GrabWP finaliza o provisionamento por meio de webhooks em um evento payment.received, portanto, um webhook repetido ou duplicado não cria um segundo tenant nem cobra em dobro. Segundo, o plano pago que um cliente seleciona tem que mapear perfeitamente para qualquer que seja o provedor que realmente processa o dinheiro. Terceiro, tudo tem que continuar funcionando após a primeira venda: renovações, expirações, cancelamentos e cartões recusados são situações normais de um negócio de assinaturas, não casos extremos.

O GrabWP trata o billing como um registro conectável em vez de um gateway único e rígido. Essa é a decisão de design que torna o resto deste artigo possível: você escolhe um provedor por plano e o registro cuida da integração.

Polar.sh: checkout hospedado ou incorporado para SaaS global

O Polar.sh é a escolha nativa para assinaturas de SaaS global. Ele oferece um checkout hospedado que fica do lado do Polar, ou um checkout incorporado que você insere no seu próprio fluxo de cadastro, dependendo do quanto da experiência você deseja manter no seu domain.

O Polar é ideal quando seus clientes são internacionais, pagam com cartão e esperam um checkout de assinatura moderno. Você cria um produto no Polar e, em seguida, mapeia seu plano pago do GrabWP para esse Product ID do Polar. Quando um cliente finaliza a compra, o Polar lida com o pagamento e dispara o webhook que aciona o provisionamento. Como a finalização do provisionamento é idempotente, o site tenant é criado exatamente uma vez, mesmo se o Polar tentar reenviar a notificação.

A opção hospedada é o caminho mais rápido para começar a vender: menos coisas para construir, menos manutenção e a interface de pagamento não é problema seu. A opção incorporada troca um pouco de configuração por um cadastro mais fluido no seu próprio site. Ambas alimentam o mesmo pipeline de provisionamento.

WooCommerce: billing self-hosted com preços de planos dinâmicos

Se você já usa o WooCommerce, ou quer manter o billing totalmente na sua própria infraestrutura, o adaptador do WooCommerce lida com o billing de assinaturas self-hosted. A vantagem aqui é o controle e a precificação dinâmica de planos: seus preços ficam na sua loja, sob as suas regras, com a sua lógica de impostos e cupons.

Isso é ideal para operadores que querem o checkout, faturamento e registros de clientes dentro do WordPress, em vez de um dashboard de terceiros. Os planos do WooCommerce não precisam de um Product ID do Polar, porque o adaptador do WooCommerce valida seu próprio mapeamento. Você configura o plano com base na sua loja e, no checkout, o adaptador confirma se o link é válido antes de aceitar o pagamento.

O WooCommerce exige mais de você operacionalmente. Você é o dono das chaves do gateway de pagamento, das atualizações de plugin e da manutenção da loja. Em troca, você mantém o fluxo de dinheiro e os dados dos clientes do seu lado, algo que algumas empresas e jurisdições preferem fortemente.

Provedores regionais e alternativos por meio do registro de adaptadores

Os processadores globais de cartão não cobrem todos os mercados. Muitos clientes pagam por transferência bancária local, e um checkout que ignora isso perde receita real. É aqui que o registro de adaptadores se justifica.

O SePay é distribuído como um plugin adaptador separado, não como código nativo. Ele lida com transferências bancárias vietnamitas via VietQR e se conecta ao mesmo registro de billing que o Polar e o WooCommerce usam. Instalando-o, você adiciona uma opção de provedor sem mudar o funcionamento dos planos ou do provisionamento. O cliente escaneia um código QR, paga pelo aplicativo do banco, e o pagamento confirmado conduz o mesmo fluxo de provisionamento.

O importante é o padrão, não o exemplo único. Como o billing é baseado em adaptadores, novos provedores podem ser adicionados da mesma forma. Um adaptador de billing para Stripe está em desenvolvimento, e a arquitetura é construída para que processadores adicionais possam se registrar sem ter que reescrever o checkout ou o pipeline de provisionamento. Você não fica preso apenas aos provedores que são lançados hoje.

Os adaptadores também recebem contexto de parceiros durante o checkout de provisionamento. O sistema de parceiros suporta chaves de API com escopo de parceiro e atribuição, de forma que revendedores ou afiliados podem ser rastreados durante a etapa de pagamento, em vez de serem anexados depois.

Mapeando planos para provedores

A antiga restrição era que um plano pago estava efetivamente vinculado ao Polar. Isso não é mais verdade, e a mudança é importante para qualquer pessoa que venda em vários mercados.

Criar ou editar um plano pago não exige um Product ID do Polar. Você só insere um Product ID quando tem a intenção de vender aquele plano pelo Polar. Para WooCommerce, SePay ou qualquer outro adaptador, você o deixa em branco e configura o mapeamento próprio do provedor em vez disso. Um plano é um plano; o provedor é uma decisão à parte.

A validação acontece por adaptador, no checkout, não na criação do plano. Cada adaptador de billing verifica seu próprio mapeamento quando um cliente tenta comprar. Sendo assim, um plano pago mapeado incorretamente falha de forma limpa na hora da compra, apenas naquele provedor específico, em vez de bloquear você de criar ou editar planos desde o início. Você pode montar seu catálogo completo de planos, integrar provedores aos poucos e descobrir um mapeamento ruim no momento e lugar exatos em que ele importa, em vez de lidar com um erro global.

Na prática, isso significa que você pode oferecer o mesmo plano Pro a $9.99/month pelo Polar para clientes internacionais e pelo SePay para transferência bancária local, cada um com seu próprio mapeamento validado, sem duplicar o plano.

Ciclo de vida da assinatura: expiração, cancelamento e falhas de pagamento

Uma venda é o começo, não o fim. O GrabWP inclui o gerenciamento do ciclo de vida da assinatura cobrindo os eventos que realmente mantêm um SaaS funcionando direito: expiração, cancelamento e falhas de pagamento, com o respaldo de um histórico por ação e um log de auditoria para que você possa ver o que aconteceu e quando.

A expiração e a reposição de dados (backfill) são tratadas como ações de primeira classe, não edições manuais no database. Quando uma assinatura vence, o sistema sabe. As notificações por e-mail incluem mensagens de falha de pagamento e cancelamento de assinatura, para que um cliente que teve o cartão recusado seja avisado, e um operador acompanhando as contas não precise ficar adivinhando. O cancelamento é uma ação explícita com seu próprio registro, em vez de uma mudança de estado silenciosa.

Como o provisionamento é idempotente e conduzido por webhooks, o ciclo de vida se mantém consistente mesmo quando os provedores tentam reenviar os eventos. O log de auditoria oferece o rastro necessário para responder perguntas de suporte e fazer a conciliação com os próprios registros do provedor.

Escolhendo sem arrependimentos

Escolha o Polar para assinaturas de SaaS rápidas, globais e baseadas em cartão, com checkout hospedado ou incorporado. Escolha o WooCommerce quando quiser controle self-hosted e preços dinâmicos dentro do WordPress. Adicione o SePay ou outro adaptador regional quando seus clientes pagarem localmente. Como os planos são desvinculados dos provedores e cada adaptador se valida no checkout, nenhuma dessas escolhas é definitiva, e você pode executar vários de uma vez.

O GrabWP Tenancy está em beta guiado, então preferimos alinhar expectativas honestas em vez de prometer demais. O registro de billing, os adaptadores nativos do Polar e do WooCommerce, o plugin do SePay e as ferramentas de ciclo de vida são reais hoje; o adaptador para Stripe está a caminho.

Se você está planejando o lado dos negócios de um SaaS no WordPress, comece pelo fluxo, não pelo gateway. Veja como o caminho do cadastro até o provisionamento se encaixa no nosso guia sobre como construir um SaaS no WordPress sem código, pegue gratuitamente o plugin GrabWP Tenancy e, quando estiver pronto para vender, explore a plataforma WaaS completa.