Resumo de IA
Você gostaria de aceitar pagamentos de clientes na Nigéria, Gana, Quênia ou África do Sul? Compradores nesses países esperam pagar com os métodos que usam todos os dias, como cartões locais, transferências bancárias e dinheiro móvel.
O addon Paystack conecta seus formulários ao Paystack para que os compradores concluam o pagamento em um pop-up seguro sem sair do seu site. Este tutorial mostrará como instalar e usar o addon Paystack com o WPForms.
Requisitos:
- Você precisará de uma licença Pro ou superior para acessar o addon Paystack.
- Certifique-se de ter instalado a versão 2.0.2.2 ou superior do WPForms para atender à versão mínima exigida para o addon Paystack.
- Você precisará de uma conta Paystack registrada na Nigéria, Gana, Quênia ou África do Sul.
Antes de começar, certifique-se de instalar e ativar o WPForms em seu site WordPress. Após verificar sua licença, você poderá instalar e ativar rapidamente o addon Paystack.
Conectando o Paystack ao seu site
Depois que o addon Paystack for instalado e ativado, você precisará conectar sua conta Paystack ao WPForms. Para fazer isso, você copiará suas chaves de API do seu painel Paystack para as configurações de pagamento do WPForms. Explicaremos cada etapa abaixo.
Obtendo suas chaves de API do Paystack
Para começar, faça login no seu painel Paystack. Em seguida, clique em Configurações na parte inferior do menu à esquerda.
Uma vez lá, abra a guia Chaves de API e Webhooks.
O Paystack exibe as chaves para o modo em que seu painel está. Para aceitar pagamentos reais, você precisará de suas chaves de produção, que aparecem em Configuração de API – Modo de Produção.
Observação: Novas contas Paystack começam em Modo de Teste, e as chaves de produção só ficam disponíveis depois que o Paystack ativar seu negócio. Para ativá-lo, abra a página Conformidade em seu painel Paystack, preencha cada seção e clique em Ativar Negócio. Seu painel muda para o Modo de Produção assim que o Paystack aprovar seus dados. Para as etapas completas, consulte o guia do Paystack para ativar seu negócio.
Enquanto aguarda a aprovação, você ainda pode testar o addon com suas chaves de teste. Veja a seção Testando pagamentos com o Paystack abaixo.
Em seguida, clique no ícone de olho ao lado da sua Chave Secreta Ativa. O Paystack solicitará a senha da sua conta antes de exibir a chave. Em seguida, copie a chave.
Depois disso, copie sua Chave Pública Ativa do campo abaixo dela.
Mantenha esta página aberta. Você colará ambas as chaves no WPForms na próxima etapa e voltará aqui para adicionar o URL do seu webhook.
Finalizando a Conexão no WPForms
Na área de administração do seu WordPress, vá para WPForms » Configurações e clique na guia Pagamentos.
Primeiro, verifique a configuração de Moeda na parte superior da página. Ela precisa corresponder à moeda do país onde sua conta Paystack está registrada. Por exemplo, uma conta queniana precisa de Xelim Queniano (KES).
Observação: Cada conta Paystack processa pagamentos em uma única moeda, definida pelo país que você escolheu ao se inscrever. Se a moeda do WPForms não corresponder, você verá um aviso nas configurações de pagamento e os pagamentos não serão processados até que as moedas correspondam.
Em seguida, role para baixo até a seção Paystack. Cole sua chave secreta no campo Chave Secreta Ativa. Em seguida, cole sua chave pública no campo Chave Pública Ativa.
Quando terminar, clique em Salvar Configurações.
O WPForms verifica sua chave secreta com o Paystack e confia que ambas as chaves pertencem ao modo em que você está. Se uma chave for digitada incorretamente ou pertencer ao outro modo, você verá um erro imediatamente. Chaves em produção começam com sk_live_ e pk_live_, enquanto chaves de teste começam com sk_test_ e pk_test_. Quando a conexão funciona, o Status da Conexão exibe Conectado ao Paystack no modo Produção.
Observação: O Modo de Teste e o modo ativo usam seus próprios pares de chaves. Para testar a integração do Paystack do seu formulário antes de aceitar pagamentos reais, consulte a seção Testando Pagamentos do Paystack abaixo.
Configurando Webhooks do Paystack
Webhooks são a forma como o Paystack informa ao seu site sobre atualizações de pagamento que ocorrem após um cliente enviar seu formulário. Por exemplo, um webhook informa ao WPForms quando um depósito bancário chega ou quando você reembolsa um pagamento do seu painel Paystack.
O Paystack não permite que o WPForms adicione um webhook para você, então você copiará um URL do WPForms e o colará no seu painel Paystack. Leva apenas um minuto e você só precisa fazer isso uma vez para cada modo.
Após salvar suas chaves, 2 novas configurações aparecerão na seção Paystack. Deixe Ativar Webhooks ativado. Em seguida, clique no ícone de cópia ao lado do campo Endpoint de Webhooks para copiar seu URL de webhook.
Agora volte para a página Chaves de API e Webhooks no seu painel Paystack. Cole o URL no campo URL de Webhook Ativo. Em seguida, clique em Salvar alterações.
O WPForms agora receberá atualizações de pagamento do Paystack.
Observação: O Paystack mantém configurações de webhook separadas para o Modo de Teste e o Modo Ativo, mas o WPForms usa o mesmo URL para ambos. Se você estiver testando primeiro, cole o URL no campo URL de Webhook de Teste. Se você usar ambos os modos, adicione-o a ambos os campos.
Adicionando o Paystack aos seus formulários
Após conectar sua conta, você estará pronto para aceitar pagamentos em seus formulários. Para começar, crie um novo formulário ou edite um existente para abrir o construtor de formulários.
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 Lista Suspensa. Ele também precisa de um campo de E-mail, pois o Paystack exige o endereço de e-mail do cliente. Não há um campo Paystack separado para adicionar. O Paystack coleta os detalhes do pagamento em seu próprio pop-up quando o formulário é enviado.
Em seguida, vá para Pagamentos » Paystack no construtor de formulários e ative a opção Ativar pagamentos Paystack.
Em seguida, preencha as configuraçõ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. Ela aparece nos detalhes do pagamento no seu painel Paystack.
- E-mail do Cliente: O campo em seu formulário que contém o endereço de e-mail do cliente. Esta configuração é obrigatória. O 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 em seu formulário que contém o nome do cliente. Ele 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 os selecionará para você.
Observação: Pagamentos Paystack exigem o envio de formulário AJAX, que está ativado por padrão para novos formulários. Se estiver desativado, o WPForms o lembrará ao salvar o formulário. Para ativá-lo novamente, vá para Configurações » Geral, abra a seção Avançado e marque Ativar envio de formulário AJAX.
Quando terminar, salve seu formulário. Ele agora está pronto para aceitar pagamentos.
Como os clientes pagam com o Paystack
Quando um cliente envia seu formulário, um pop-up do Paystack abre sobre a página. O formulário só é enviado após o pagamento ser concluído.
As opções de pagamento no pop-up dependem da moeda da sua conta Paystack:
- Naira Nigeriana (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, o pop-up fecha e o cliente vê a mensagem de confirmação do seu formulário.
Testando pagamentos com o Paystack
Antes de começar a receber pagamentos reais, é uma boa ideia fazer um teste de pagamento em seu formulário. O modo de teste do Paystack permite que você conclua todo o fluxo sem que nenhum dinheiro seja movimentado.
Ativando o modo de teste
Para garantir que nenhum pagamento real seja processado enquanto você está testando, vá para WPForms » Configurações e clique na aba Pagamentos.
Em Paystack, ative a opção Modo de Teste. Os campos Chave Secreta de Teste e Chave Pública de Teste aparecerão no lugar dos campos ativos.
Observação: O Modo de Teste e o modo ativo são configurados separadamente, portanto, você precisará adicionar suas chaves de teste aqui, mesmo que já tenha conectado suas chaves ativas. O WPForms o lembrará disso ao alternar os modos.
Em seguida, volte para a página Chaves de API e Webhooks no seu painel Paystack. Se o seu painel estiver no Modo Ativo, use o seletor no canto superior direito do painel para alternar para o Modo de Teste.
Copie sua Chave Secreta de Teste e cole-a no campo Chave Secreta de Teste no WPForms. Em seguida, faça o mesmo para sua Chave Pública de Teste.
Clique em Salvar Configurações. O Status da Conexão exibirá Conectado ao Paystack em modo de teste.
Para receber webhooks durante os testes, cole seu URL do Endpoint de Webhooks no campo URL de Webhook de Teste no seu painel Paystack também.
Realizando um pagamento de teste
Em seguida, abra uma página com seu formulário Paystack e preencha-o como um cliente faria. Em seguida, envie o formulário para abrir o popup do Paystack.
No modo de teste, a opção Cartão exibe cenários de teste em vez de campos de cartão. Selecione Sucesso e clique no botão Pagar para concluir um pagamento de teste bem-sucedido. Para ver como seu formulário lida com um pagamento falho, escolha Recusado em vez disso.
Para inserir os detalhes do cartão você mesmo, clique em Usar outro cartão e use um dos cartões de teste do Paystack. Por exemplo, o número do cartão 4084 0840 8408 4081 com CVV 408 e qualquer data de validade futura conclui um pagamento bem-sucedido. A mesma página lista números de teste para transferências bancárias e de dinheiro móvel também.
Visualizando seus pagamentos de teste
Para encontrar seus pagamentos de teste, vá para WPForms » Pagamentos e ative o seletor Dados de Teste.
Clique em um pagamento para ver seus detalhes. A partir daí, o link Ver no Paystack abre a transação no seu painel Paystack.
Para mais informações sobre detalhes de pagamento, status e tendências, confira nosso guia para visualizar e gerenciar pagamentos.
Configurando Lógica Condicional (Opcional)
A lógica condicional permite que você decida quando uma cobrança do Paystack deve ser processada, com base no que o cliente seleciona em seu formulário. Por exemplo, você pode querer cobrar apenas clientes que escolhem uma opção paga.
Para configurar isso, vá para Pagamentos » Paystack no construtor de formulários e ative Habilitar Lógica Condicional. Em seguida, crie a regra que decide quando processar a cobrança.
Para mais exemplos, veja nosso tutorial sobre usando lógica condicional.
Perguntas Frequentes
Abaixo, abordamos algumas das perguntas mais comuns sobre o uso do addon Paystack.
Quais países e moedas posso usar com o addon Paystack?
O addon funciona com contas Paystack registradas na Nigéria, Gana, Quênia e África do Sul. Cada conta processa pagamentos na moeda de seu país: Naira Nigeriana (NGN), Cedi Ganês (GHS), Xelim Queniano (KES) ou Rand Sul-Africano (ZAR). Defina a moeda correspondente em WPForms » Configurações » Pagamentos.
Por que meu pagamento do Paystack está marcado como Pendente?
Transferências bancárias e pagamentos por dinheiro móvel podem levar um pouco mais de tempo para confirmar do que pagamentos com cartão. Se um cliente escolher uma dessas opções e fechar o popup antes que o Paystack confirme o pagamento, o WPForms salva 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 cupom. Assim que o Paystack confirmar o pagamento, o WPForms o marcará como Concluído e finalizará essas etapas. Com webhooks configurados, isso geralmente leva alguns segundos. Sem eles, pode levar até 30 minutos.
Preciso configurar webhooks?
Nós recomendamos. Sem webhooks, o WPForms verifica com o Paystack a cada 15 minutos e atualiza pagamentos que ainda estão pendentes, então pagamentos por transferência bancária e dinheiro móvel ainda são concluídos. Pagamentos com cartão permanecem como Processados por até 30 minutos até que essa verificação os marque como Concluídos. No entanto, reembolsos que você fizer no seu painel do Paystack não serão sincronizados de volta para o WPForms.
Se o WPForms perceber que os pagamentos estão sendo atualizados apenas por meio dessas verificações, ele exibirá um aviso no seu painel WordPress pedindo para verificar a configuração do seu webhook. Para corrigir, copie a URL do Webhooks Endpoint em WPForms » Configurações » Pagamentos para o campo Webhook URL do modo que você está usando no seu painel Paystack.
Por que 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. Aqui estão as causas mais comuns e como corrigir cada uma:
- Paystack não está conectado no modo atual: Por exemplo, o Modo de Teste está ativado, mas nenhuma chave de teste foi salva. Vá para WPForms » Configurações » Pagamentos e adicione as chaves para o modo que você está usando.
- As moedas não coincidem: O Paystack só processa pagamentos na moeda da sua conta, então alterar a moeda do WPForms pausa os pagamentos. Defina a moeda de volta para corresponder à sua conta do Paystack.
- Envio de formulário AJAX está desativado: Pagamentos do Paystack precisam do envio de formulário AJAX, e alguns modelos de formulário, incluindo os modelos de Registro de Usuário, o desativam por padrão. Para ativá-lo, abra as Configurações » Geral do seu formulário, expanda Avançado e marque Ativar envio de formulário AJAX.
Por que vejo “O valor do pagamento está abaixo do mínimo permitido”?
O Paystack define um valor 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 cair abaixo desse valor, ajuste seus preços ou use a lógica condicional para pular a cobrança para esses pedidos.
O WPForms armazena os detalhes do cartão dos meus clientes?
Não. O popup do Paystack é hospedado pelo Paystack, então os detalhes do cartão vão diretamente para o Paystack e nunca tocam no seu site. O WPForms apenas salva o registro do pagamento, juntamente com a bandeira do cartão e os últimos 4 dígitos para sua referência.
É isso! Agora você 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 de olho nos pagamentos que chegam através dos seus formulários? Confira nosso guia para visualizar e gerenciar pagamentos para saber mais sobre detalhes de pagamento, status e reembolsos.
