Resumo de IA
Gostaria de aceitar pagamentos de clientes na Nigéria, Gana, Quénia ou África do Sul? Compradores nestes países esperam pagar com os métodos que já usam diariamente, como cartões locais, transferências bancárias e dinheiro móvel.
O complemento Paystack liga os seus formulários ao Paystack para que os compradores completem o seu pagamento numa janela pop-up segura sem sair do seu site. Este tutorial irá mostrar-lhe como instalar e usar o complemento Paystack com o WPForms.
Requisitos:
- Precisará de uma licença Pro ou superior para aceder ao complemento Paystack.
- Certifique-se de que instalou a versão 2.0.2.2 ou superior do WPForms para cumprir a versão mínima exigida para o complemento Paystack.
- Precisará de uma conta Paystack registada na Nigéria, Gana, Quénia ou África do Sul.
Antes de começar, certifique-se de que instala e ativa o WPForms no seu site WordPress. Após verificar a sua licença, poderá rapidamente instalar e ativar o complemento Paystack.
Ligar Paystack ao seu site
Assim que o complemento Paystack estiver instalado e ativado, precisará de ligar a sua conta Paystack ao WPForms. Para fazer isto, irá copiar as suas chaves de API do seu painel Paystack para as suas definições de pagamento do WPForms. Explicaremos cada passo abaixo.
Obter as suas chaves de API Paystack
Para começar, inicie sessão no seu painel Paystack. Em seguida, clique em Definições na parte inferior do menu à esquerda.
Uma vez lá, abra o separador Chaves de API e Webhooks.
O Paystack mostra as chaves para o modo em que o seu painel se encontra. Para aceitar pagamentos reais, precisará das suas chaves em direto, que aparecem em Configuração de API – Modo em Direto.
Nota: Novas contas Paystack começam em Modo de Teste, e as chaves em direto só ficam disponíveis depois de o Paystack ativar o seu negócio. Para o ativar, abra a página Conformidade no seu painel Paystack, complete cada secção e clique em Ativar Negócio. O seu painel muda para Modo em Direto assim que o Paystack aprovar os seus detalhes. Para os passos completos, consulte o guia do Paystack para ativar o seu negócio.
Enquanto espera pela aprovação, ainda pode experimentar o complemento com as suas chaves de teste. Consulte a secção Testar pagamentos Paystack abaixo.
De seguida, clique no ícone do olho ao lado da sua Chave Secreta Ativa. O Paystack pedirá a palavra-passe da sua conta antes de mostrar a chave. Em seguida, copie a chave.
Depois disso, copie a sua Chave Pública Ativa do campo abaixo dela.
Mantenha esta página aberta. Colará ambas as chaves no WPForms no próximo passo e voltará aqui para adicionar o URL do seu webhook.
Finalizar a Conexão no WPForms
Na sua área de administração do WordPress, vá a WPForms » Definições e clique no separador Pagamentos.
Primeiro, verifique a definição de Moeda no topo da página. Tem de corresponder à moeda do país onde a sua conta Paystack está registada. Por exemplo, uma conta queniana precisa de Xelim Queniano (KES).
Nota: Cada conta Paystack processa pagamentos numa única moeda, definida pelo país que escolheu quando se inscreveu. Se a moeda do WPForms não corresponder, verá um aviso nas suas definições de pagamento e os pagamentos não serão efetuados até que as moedas correspondam.
De seguida, desloque-se para baixo até à secção Paystack. Cole a sua chave secreta no campo Chave Secreta Ativa. Em seguida, cole a sua chave pública no campo Chave Pública Ativa.
Quando terminar, clique em Guardar Definições.
O WPForms verifica a sua chave secreta com o Paystack e confirma que ambas as chaves pertencem ao modo em que se encontra. Se uma chave for digitada incorretamente ou pertencer ao outro modo, verá um erro de imediato. As chaves em produção começam com sk_live_ e pk_live_, enquanto as chaves de teste começam com sk_test_ e pk_test_. Quando a ligação funciona, o Estado da Ligação indica Ligado ao Paystack em modo de produção.
Nota: O Modo de Teste e o modo ativo utilizam cada um o seu próprio par de chaves. Para experimentar a integração Paystack do seu formulário antes de aceitar pagamentos reais, consulte a secção Testar Pagamentos Paystack abaixo.
Configurar Webhooks Paystack
Webhooks são a forma como o Paystack informa o seu site sobre atualizações de pagamento que ocorrem após um cliente submeter o seu formulário. Por exemplo, um webhook informa o WPForms quando uma transferência bancária chega ou quando reembolsa um pagamento do seu painel Paystack.
O Paystack não permite que o WPForms adicione um webhook por si, pelo que copiará um URL do WPForms e colá-lo-á no seu painel Paystack. Demora apenas um minuto e só precisa de o fazer uma vez para cada modo.
Após guardar as suas chaves, 2 novas definições aparecem na secção Paystack. Deixe Ativar Webhooks ligado. Em seguida, clique no ícone de cópia ao lado do campo Endpoint de Webhooks para copiar o seu URL de webhook.
Agora volte à página Chaves API e Webhooks no seu painel Paystack. Cole o URL no campo URL de Webhook Ativo. Em seguida, clique em Guardar alterações.
O WPForms receberá agora atualizações de pagamento do Paystack.
Nota: O Paystack mantém definições de webhook separadas para o Modo de Teste e o Modo Ativo, mas o WPForms utiliza o mesmo URL para ambos. Se estiver a testar primeiro, cole o URL no campo URL de Webhook de Teste. Se utilizar ambos os modos, adicione-o a ambos os campos.
Adicionar Paystack aos seus formulários
Após ligar a sua conta, está pronto para aceitar pagamentos nos seus formulários. Para começar, crie um novo formulário ou edite um existente para abrir o construtor de formulários.
O seu formulário precisa de, pelo menos, um campo de pagamento que defina um valor, como Item Único, Vários Itens, Itens de Caixa de Seleção ou Itens de Menu Suspenso. Precisa também de um campo de E-mail, uma vez que a Paystack exige o endereço de e-mail do cliente. Não há um campo Paystack separado para adicionar. A Paystack recolhe os detalhes do pagamento numa janela pop-up própria quando o formulário é submetido.
Em seguida, vá a Pagamentos » Paystack no construtor de formulários e ative o interruptor Ativar pagamentos Paystack.
Depois, preencha as definições para os pagamentos deste formulário:
- Descrição do Pagamento: Uma breve descrição do pagamento, como o nome do seu produto ou serviço. Aparece nos detalhes do pagamento no seu painel Paystack.
- E-mail do Cliente: O campo no seu formulário que contém o endereço de e-mail do cliente. Esta definição é obrigatória. A Paystack precisa de um endereço de e-mail para criar o pagamento e envia o recibo para esse endereço.
- Nome do Cliente: O campo no seu formulário que contém o nome do cliente. Aparece nos detalhes do pagamento no seu painel Paystack.
Se o seu formulário já tiver um campo de E-mail e um campo de Nome, o WPForms seleciona-os para si.
Nota: Os pagamentos Paystack necessitam de submissão de formulário AJAX, que está ativada por defeito para novos formulários. Se estiver desativada, o WPForms irá lembrá-lo quando guardar o formulário. Para a reativar, vá a Definições » Geral, abra a secção Avançadas e marque Ativar submissão de formulário AJAX.
Quando terminar, guarde o seu formulário. Está agora pronto para aceitar pagamentos.
Como os clientes pagam com Paystack
Quando um cliente submete o seu formulário, uma janela pop-up Paystack abre-se sobre a página. O formulário só é submetido após o pagamento ser processado.
As opções de pagamento na janela pop-up dependem da moeda da sua conta Paystack:
- Nairas Nigerianas (NGN): Cartão e transferência bancária
- Cedi Ganês (GHS): Cartão e dinheiro móvel
- Xelim Queniano (KES): Cartão e dinheiro móvel
- Rand Sul-Africano (ZAR): Cartão
Assim que o pagamento for bem-sucedido, a janela pop-up fecha-se e o cliente vê a mensagem de confirmação do seu formulário.
Testar pagamentos Paystack
Antes de começar a aceitar pagamentos reais, é uma boa ideia executar um pagamento através do seu formulário. O modo de teste da Paystack permite-lhe completar todo o fluxo sem que qualquer dinheiro seja movimentado.
Ativar o modo de teste
Para garantir que nenhum pagamento real é processado enquanto está a testar, vá a WPForms » Definições e clique no separador Pagamentos.
Em Paystack, ative o interruptor Modo de Teste. Os campos Chave Secreta de Teste e Chave Pública de Teste aparecerão no lugar dos campos ativos.
Nota: O Modo de Teste e o modo ativo são configurados separadamente, pelo que terá de adicionar as suas chaves de teste aqui, mesmo que já tenha ligado as suas chaves ativas. O WPForms irá lembrá-lo disto quando mudar de modo.
Em seguida, volte à página Chaves API e Webhooks no seu painel Paystack. Se o seu painel estiver em Modo Ativo, use o interruptor no canto superior direito do painel para mudar para o Modo de Teste.
Copie a sua Chave Secreta de Teste e cole-a no campo Chave Secreta de Teste no WPForms. Depois, faça o mesmo para a sua Chave Pública de Teste.
Clique em Guardar Definições. O Estado da Ligação indicará Ligado à Paystack em modo de Teste.
Para receber webhooks durante os testes, cole também o URL do seu Ponto Final de Webhooks no campo URL de Teste de Webhook no seu painel Paystack.
Realizar um pagamento de teste
Em seguida, abra uma página com o seu formulário Paystack e preencha-a como um cliente faria. Depois, submeta o formulário para abrir o popup da Paystack.
Em modo de teste, a opção Cartão mostra cenários de teste em vez de campos de cartão. Selecione Sucesso e clique no botão Pagar para completar um pagamento de teste bem-sucedido. Para ver como o seu formulário lida com um pagamento falhado, escolha Recusado em vez disso.
Para introduzir os detalhes do cartão, clique em Usar outro cartão e utilize um dos cartões de teste da Paystack. Por exemplo, o número de cartão 4084 0840 8408 4081 com CVV 408 e qualquer data de validade futura completa um pagamento bem-sucedido. A mesma página lista números de teste para transferências bancárias e dinheiro móvel.
Ver os seus pagamentos de teste
Para encontrar os seus pagamentos de teste, vá a WPForms » Pagamentos e ative o interruptor Dados de Teste.
Clique num pagamento para ver os seus detalhes. A partir daí, a ligação Ver na Paystack abre a transação no seu painel Paystack.
Para mais informações sobre detalhes de pagamento, estados e tendências, consulte o nosso guia sobre visualização e gestão de pagamentos.
Configurar Lógica Condicional (Opcional)
A lógica condicional permite-lhe decidir quando uma cobrança Paystack deve ser processada, com base no que o cliente seleciona no seu formulário. Por exemplo, pode querer apenas cobrar clientes que escolhem uma opção paga.
Para configurar isto, vá a Pagamentos » Paystack no construtor de formulários e ative Ativar Lógica Condicional. Depois, construa a regra que decide quando processar a cobrança.
Para mais exemplos, veja o nosso tutorial sobre utilização de lógica condicional.
Perguntas Frequentes
Abaixo, abordámos algumas das questões mais comuns sobre a utilização do addon Paystack.
Que países e moedas posso usar com o complemento Paystack?
O addon funciona com contas Paystack registadas na Nigéria, Gana, Quénia e África do Sul. Cada conta processa pagamentos na moeda do seu país: Naira Nigeriana (NGN), Cedi Ganês (GHS), Xelim Queniano (KES) ou Rand Sul-Africano (ZAR). Defina a moeda correspondente em WPForms » Definições » Pagamentos.
Porque é que o meu pagamento Paystack está marcado como Pendente?
As transferências bancárias e os pagamentos por dinheiro móvel podem demorar um pouco mais a confirmar do que os pagamentos com cartão. Se um cliente escolher uma destas opções e fechar o popup antes de a Paystack confirmar o pagamento, o WPForms guarda a entrada e marca o pagamento como Pendente.
Até que o pagamento seja confirmado, o WPForms retém os e-mails de notificação do formulário. Ele também espera para ativar contas criadas com o User Registration addon e para contar o uso de qualquer cupão. Assim que o Paystack confirmar o pagamento, o WPForms marca-o como Concluído e finaliza estes passos. Com webhooks configurados, isto demora geralmente alguns segundos. Sem eles, pode demorar até 30 minutos.
Preciso de configurar webhooks?
Recomendamo-lo. Sem webhooks, o WPForms verifica com o Paystack a cada 15 minutos e atualiza os pagamentos que ainda estão pendentes, pelo que as transferências bancárias e os pagamentos por dinheiro móvel ainda são concluídos. Os pagamentos com cartão permanecem Processados por até 30 minutos até que essa verificação os marque como Concluídos. No entanto, os reembolsos que efetuar no seu painel do Paystack não serão sincronizados de volta para o WPForms.
Se o WPForms detetar que os pagamentos só estão a ser atualizados através destas verificações, exibe um aviso na sua área de administração WordPress a pedir para verificar a sua configuração de webhook. Para corrigir, copie o URL do Webhooks Endpoint de WPForms » Definições » Pagamentos para o campo Webhook URL para o modo que está a usar no seu painel Paystack.
Porque é que o meu formulário diz “Pagamentos indisponíveis no momento”?
Esta mensagem aparece quando o WPForms não consegue processar um pagamento do Paystack no seu formulário. Eis as causas mais comuns e como corrigir cada uma delas:
- O Paystack não está ligado no modo atual: Por exemplo, o Modo de Teste está ativado, mas nenhuma chave de teste foi guardada. Aceda a WPForms » Definições » Pagamentos e adicione as chaves para o modo que está a utilizar.
- As moedas não correspondem: O Paystack só processa pagamentos na moeda da sua conta, pelo que alterar a moeda do WPForms pausa os pagamentos. Defina a moeda de volta para corresponder à da sua conta Paystack.
- A submissão de formulário AJAX está desativada: Os pagamentos do Paystack necessitam de submissão de formulário AJAX, e alguns modelos de formulário, incluindo os modelos de Registo de Utilizador, têm-na desativada por defeito. Para a ativar, abra as Definições » Geral do seu formulário, expanda Avançadas e marque Ativar submissão de formulário AJAX.
Porque é que vejo “O montante do pagamento está abaixo do mínimo permitido”?
O Paystack define um montante mínimo para cada moeda, e o WPForms verifica o total antes de abrir o popup. Os mínimos são NGN 50, GHS 0.10, KES 3 e ZAR 1. Se o total do seu formulário puder ficar abaixo deste montante, ajuste os seus preços ou use lógica condicional para saltar a cobrança para essas encomendas.
O WPForms armazena os detalhes do cartão dos meus clientes?
Não. O popup do Paystack é alojado pelo Paystack, pelo que os detalhes do cartão vão diretamente para o Paystack e nunca tocam no seu site. O WPForms apenas guarda o registo do pagamento, juntamente com a marca do cartão e os últimos 4 dígitos para sua referência.
É tudo! Agora pode aceitar pagamentos com cartão, transferência bancária e dinheiro móvel através do addon Paystack do WPForms.
Em seguida, quer ficar mais atento aos pagamentos que entram através dos seus formulários? Consulte o nosso guia para visualizar e gerir pagamentos para saber mais sobre detalhes de pagamento, estados e reembolsos.
