Como ligar o Payora ao WooCommerce Subscriptions

O WooCommerce Subscriptions é exigente — e isso é bom. Mantém a faturação recorrente organizada, mas também significa que não pode tratar o Payora como um plugin de pagamento único e esperar que a lógica das renovações se resolva sozinha.

Este guia tem um objetivo específico: adicionar o Payora a uma loja WooCommerce existente que já utiliza a extensão Subscriptions, sem alterar o resto da loja. Se pretende apenas que os novos pedidos recorrentes utilizem o Payora, isto basta. Se quer reconstruir todo o fluxo de pagamentos, este não é o artigo certo.

Antes de começar, um pequeno aviso. A configuração de subscrições afeta o checkout, os avisos de renovação, o comportamento dos métodos de pagamento guardados e os registos de encomendas. Basta falhar uma configuração para criar problemas nas renovações mais tarde.

1. Confirme o cenário exato do WooCommerce Subscriptions

Comece pela loja que tem, não pela loja que gostaria de ter. Se o WooCommerce já está ativo e a extensão WooCommerce Subscriptions também, a tarefa costuma ser adicionar o Payora às novas subscrições sem alterar os produtos, os impostos, os métodos de envio ou os modelos de e-mail existentes.

Parece uma tarefa modesta porque é mesmo. O objetivo não é reescrever a gestão de encomendas de toda a loja, mas apenas encaminhar pelo Payora os checkouts das subscrições elegíveis.

Se a sua loja ainda só aceita pagamentos únicos, pare aqui e altere primeiro a estrutura da loja. Se já tem subscrições, pode avançar.

Para conhecer melhor o Payora no comércio eletrónico, o guia sobre gateways de pagamento em criptomoedas para comércio eletrónico pode ajudar a comparar modelos de pagamento antes de alterar o checkout ativo.

2. Verifique os requisitos do plugin e da conta

Precisa de acesso de administrador ao WordPress. Também precisa do WooCommerce, do WooCommerce Subscriptions e de uma conta de comerciante Payora com as credenciais necessárias para o ambiente de produção ou de testes.

Antes de mais, verifique a lista de plugins. Um ecrã de administração organizado não é garantia de que está tudo pronto, mas permite confirmar se os elementos básicos estão instalados.

Abra a conta Payora e confirme os dados do comerciante, as chaves de API e quaisquer valores de callback ou webhook disponibilizados pela conta. Se o Payora fornecer valores diferentes para o ambiente de testes e o ambiente ativo, guarde-os em locais separados.

Não ignore a verificação da conta. Uma chave em falta pode fazer com que o checkout da subscrição pareça funcionar no site, enquanto a parte recorrente falha em segundo plano.

Confirme também que a conta do proprietário da loja ou do programador tem permissões para editar as definições de pagamento do WooCommerce. Uma conta com permissões limitadas pode atrasar toda a configuração.

3. Encontre as definições de pagamento do Payora no WooCommerce

No WordPress, aceda a WooCommerce, depois a Definições e, por fim, a Pagamentos. É aí que os gateways costumam aparecer, embora o caminho exato possa variar se o Payora estiver disponível como opção integrada, extensão separada ou integração personalizada.

Procure o Payora na lista de métodos de pagamento. Se aparecer com um interruptor para o ativar e um botão de definições, provavelmente está a utilizar um gateway que pode ser configurado diretamente no WooCommerce.

Se o Payora não aparecer, confirme se o plugin está instalado, se a extensão está ativa e se a integração exige um conector separado. Três verificações são melhores do que uma suposição.

Preste atenção às indicações relativas às subscrições. Alguns gateways suportam o checkout normal, mas não as renovações recorrentes. Essa diferença é mais importante do que o nome do botão.

Uma nota rápida sobre a administração: se a página de definições tiver um modo de teste, mantenha-o ativo por enquanto. Um único clique no ambiente de produção pode criar uma subscrição real antes de estar tudo preparado.

4. Ligue as credenciais do Payora ao checkout das subscrições

Introduza o identificador de comerciante do Payora, as chaves de API e qualquer valor secreto exatamente como foram fornecidos. Um único erro de digitação pode impedir a autenticação e, quando se trata de faturação recorrente, talvez só se aperceba disso na primeira tentativa de renovação.

Se a configuração incluir um URL de callback ou um endpoint de webhook, adicione-o nos dois locais: na conta Payora e nas definições do gateway do WooCommerce, se a integração o exigir. Para configurar webhooks do Payora no WooCommerce, siga os valores e os passos indicados pela integração; o evento de renovação precisa de comunicar com o WooCommerce para que o estado da subscrição seja atualizado quando o pagamento for aceite ou recusado.

Esta é a parte mais técnica, mas resume-se sobretudo a introduzir tudo com atenção. Copie, cole, confirme e guarde.

Para uma referência técnica mais aprofundada, consulte o guia de integração da API de pagamentos em criptomoedas do Payora, sobretudo se a sua configuração não for um gateway pronto a usar.

Há uma expressão que muitos lojistas pesquisam e depois complicam mais do que o necessário: «Como configurar o Payora no WooCommerce Subscriptions». O processo é mais simples do que parece se o gateway já suportar a lógica das encomendas recorrentes. O essencial é garantir que tanto o checkout inicial como o callback de renovação utilizam os mesmos dados da conta Payora.

Guarde as definições, volte a carregar a página e confirme que continuam lá. Uma definição que desaparece ao atualizar a página não ficou guardada.

5. Configure o comportamento de pagamento das subscrições

Agora, abra as definições do WooCommerce Subscriptions e verifique o comportamento das renovações. Os pontos mais importantes são os métodos de pagamento guardados, as tentativas de cobrança e a possibilidade de os clientes usarem o Payora tanto no primeiro pagamento como nas renovações seguintes.

Algumas lojas permitem usar o Payora apenas na adesão e passam depois as renovações para outro método. Outras deixam o Payora tratar de ambos. As regras dos seus produtos determinam qual o modelo mais adequado.

Se o gateway guardar as credenciais de pagamento dos clientes num formato reconhecido pelo WooCommerce Subscriptions, ative a opção de métodos de pagamento guardados. Caso contrário, não tente forçar essa opção.

Analise atentamente as tentativas de cobrança. Uma renovação falhada pode desencadear e-mails, alterações de estado ou regras de cancelamento. Estas ações devem estar de acordo com a política de apoio ao cliente da loja, e não com uma predefinição que nunca verificou.

Tenha atenção à utilização de diferentes métodos de pagamento na mesma subscrição. Isso pode acontecer se um cliente começar com um gateway e mudar mais tarde para o Payora. É possível gerir configurações mistas, mas a mudança deve ser intencional.

Se procura uma forma prática de avaliar a qualidade dos pagamentos depois de ativar esta opção, leia como medir o sucesso dos pagamentos em criptomoedas. É mais fácil corrigir padrões de renovação problemáticos desde o início do que fazê-lo depois de um mês de pedidos de apoio.

6. Teste a adesão a uma subscrição e a primeira renovação

Comece por testar um produto de subscrição. Basta um plano. Abra a página do produto, faça uma encomenda de subscrição e acompanhe todo o percurso, do carrinho à confirmação.

Se possível, utilize uma conta de cliente de teste. Depois, confirme se o WooCommerce criou o registo da subscrição, a encomenda principal e o estado inicial correto.

O teste da primeira renovação é mais importante do que o do primeiro checkout. Um checkout pode ser concluído com sucesso enquanto a lógica de renovação falha mais tarde sem dar nas vistas.

Acione o evento de renovação no ambiente de testes ou siga o calendário de renovações que configurou. Depois, confirme se o WooCommerce atualiza o estado da subscrição após receber o resultado do pagamento do Payora.

Se quiser uma lista de verificação para esta etapa, o artigo sobre como testar um pagamento em criptomoedas pode ser útil. Os mesmos princípios aplicam-se aqui: teste o pagamento e, em seguida, confirme o resultado.

Anote o resultado exato do teste. A encomenda passou para ativa, pendente ou suspensa? O e-mail de renovação foi enviado? O registo da encomenda na administração inclui a nota esperada?

Nota rápida sobre os testes: não ignore a renovação. Nunca.

7. Verifique as mensagens para os clientes e a gestão de encomendas na administração

Os clientes devem ver a mensagem de pagamento correta no checkout, e o texto deve corresponder ao funcionamento real do Payora. Se o gateway redirecionar o cliente, informe-o. Se a confirmação do pagamento chegar mais tarde, não indique prematuramente que a encomenda está concluída.

Verifique o e-mail de confirmação da subscrição. Depois, verifique o e-mail de renovação. Por fim, veja o e-mail de cancelamento, caso a loja envie um. São três e-mails e três oportunidades para encontrar mensagens incoerentes.

Na administração, abra o registo da subscrição e a encomenda associada. Deve encontrar o nome do gateway, o estado do pagamento e qualquer nota que identifique a tentativa de renovação ou o resultado do callback.

Se a equipa de apoio tratar de reembolsos ou de análises manuais, também precisa de ver estes dados. Um registo de administração claro poupa tempo nos primeiros dez pedidos de apoio — e, provavelmente, nos seguintes também.

Uma referência interna útil é o guia sobre como passar de pagamentos em criptomoedas processados manualmente para pagamentos automatizados. Algumas lojas estão a fazer essa transição para a faturação de subscrições e precisam de manter os registos internos coerentes.

Evite mensagens vagas. «Pagamento recebido» só é adequado se a renovação estiver realmente concluída. Se ainda estiver pendente de confirmação na rede, diga-o.

8. Considere os casos especiais das subscrições existentes

As subscrições existentes são a parte mais complicada. Se os clientes já pagam por outro método, decida se pretende que o mantenham ou se quer que passem para o Payora apenas quando renovarem manualmente ou voltarem a subscrever.

Em muitas lojas, a regra mais simples é também a mais clara: as novas subscrições usam o Payora e os clientes existentes mantêm o método de pagamento atual até surgir uma alteração natural. Assim, evita obrigar os clientes a tomar uma decisão que nunca lhes foi pedida.

Se pretende migrar as subscrições atuais, verifique se o WooCommerce Subscriptions permite alterar o método sem criar uma nova subscrição. Caso não permita, prepare uma forma de voltar a subscrever e explique o processo claramente aos clientes.

Essa explicação é importante. As pessoas aceitam um novo método de faturação se souberem o motivo. O que não apreciam são as surpresas.

Os administradores da loja também devem decidir o que fazer com as antigas encomendas de renovação. Mantenha-as legíveis e preserve o histórico. Não apague registos só porque mudou de gateway.

Uma pergunta prática surge com frequência: e se o cliente quiser usar o Payora apenas na próxima renovação? Nesse caso, teste primeiro o processo de alteração num ambiente de preparação, porque o objeto da subscrição e o registo do método de pagamento podem não ser atualizados ao mesmo tempo.

Outra questão é saber se o Payora deve aparecer em todos os produtos ou apenas nos produtos de subscrição. Se a sua loja vender tanto bens físicos como serviços recorrentes, defina regras separadas desde já, em vez de deixar isso para mais tarde.

Para quem está a planear o processo de ponta a ponta, saber como aceitar pagamentos recorrentes com Payora no WooCommerce implica testar tanto o primeiro pagamento como as renovações, além de confirmar as mensagens apresentadas ao cliente e os estados registados na administração.

Tenha esta lista à mão durante a implementação. É curta de propósito.

Se mais tarde precisar de alterar a própria estrutura da integração, o artigo sobre gateways de pagamento em criptomoedas para profissionais independentes só será o passo seguinte mais indicado se o seu modelo de subscrições também se aproximar da faturação de serviços a clientes, já que é aí que as expectativas de pagamentos recorrentes costumam coincidir.

Uma última nota prática: se o Payora e o WooCommerce apresentarem horários diferentes, confie primeiro nos registos e só depois no ecrã. Os ecrãs podem demorar a atualizar. Os registos contam o que aconteceu.