Testando Pagamentos Square

O Add-on Square é um Recurso Pro

Desbloqueie o Add-on Square e outros recursos poderosos para expandir seus negócios.

Obter WPForms Pro

Gostaria de processar alguns pagamentos de teste para sua integração com o Square antes de publicar seu formulário de pagamento? Ao ativar o Modo de Teste nas configurações de pagamento do WPForms, você pode experimentar facilmente os pagamentos do Square em seu site antes de disponibilizá-los aos seus usuários.

Este tutorial mostrará como testar seus pagamentos do Square no WPForms.

Testando pagamentos square

Requisitos: O teste de pagamentos do Square está disponível para todos os usuários do WPForms. No entanto, você precisará de um nível de licença Pro ou superior para acessar o add-on Square Pro.

Além disso, o Square exige que seu site tenha SSL (HTTPS) ativado na página onde você está adicionando um formulário de pagamento ativo, pois isso permite que você envie dados de cartão de crédito com segurança para o Square. Para mais detalhes, consulte o guia do WPBeginner sobre como adicionar SSL e HTTPS no WordPress.


Antes de começar, certifique-se de que o WPForms esteja instalado e ativado em seu site WordPress e que você tenha verificado sua licença.

Configurando uma Conta de Desenvolvedor Square

Primeiro, você precisará criar uma conta gratuita de Desenvolvedor Square. Isso permitirá que você configure uma Conta de Teste Sandbox e mantenha as transações reais separadas das transações de teste.

Acesse a plataforma de Desenvolvedor Square e clique em Começar.

Criando uma conta de desenvolvedor Square

Se você não tem uma conta Square existente, crie uma aqui. Você poderá ativá-la mais tarde, quando estiver pronto para começar a aceitar pagamentos reais, seguindo as instruções no e-mail de ativação enviado para o endereço associado à sua conta.

Inscrevendo-se para uma conta de desenvolvedor Square

Se você já possui uma conta de Vendedor Square, pode fazer login no Square Developer usando suas credenciais existentes.

Depois de criar sua conta ou fazer login, você verá o Painel do Desenvolvedor Square. Para começar, clique no botão azul mais (+) para criar seu primeiro aplicativo.

Adicionando um novo aplicativo no Square Developer

Isso abrirá uma janela pop-up onde você pode nomear este aplicativo (é apenas para sua referência). Em seguida, clique no botão Salvar.

Nomeando um novo aplicativo no Square Developer

Após salvar seu aplicativo, você retornará ao painel do Desenvolvedor Square e verá seu novo aplicativo listado em Aplicativos.

Em seguida, na barra lateral esquerda, clique em Contas de teste Sandbox.

Abrir Contas de Teste Sandbox

Isso abrirá a página Contas de Teste Sandbox para sua conta de desenvolvedor, onde o Square cria automaticamente uma Conta de Teste Padrão para você.

Clique no botão Painel Square para a Conta de Teste Padrão para abrir seu painel.

Clique em Painel Square para abrir o painel sandbox

Observação: Para fins deste tutorial, usaremos a Conta de Teste Padrão para testar pagamentos do Square no WPForms. No entanto, você pode criar quantas contas de teste diferentes no painel do Desenvolvedor do Square desejar e seguir as etapas abaixo para testar pagamentos com qualquer uma delas.

Para obter detalhes sobre como testar pagamentos para países da União Europeia, consulte a seção de Perguntas Frequentes abaixo.

Isso abrirá uma tela que se parece exatamente com o painel do Vendedor do Square. Deixe esta página aberta e faça login no seu site WordPress em outra aba do navegador.

Um painel de Vendedor Sandbox do Square Developer

Observação: Você deve iniciar sua Conta de Teste Sandbox no painel do Desenvolvedor do Square antes de poder conectá-la ao WPForms para testar pagamentos. Para mais detalhes, consulte a seção de Perguntas Frequentes abaixo.

Ativando o Modo de Teste do Square

Em seguida, você precisa garantir que nenhum pagamento real seja processado no Square enquanto você testa seu formulário. Para fazer isso, vá para WPForms » Configurações no seu painel do WordPress e clique em Pagamentos.

Acessando as configurações de pagamentos do WPForms

Em Square, selecione a caixa de seleção para Modo de Teste.

Habilitando o Modo de Teste para Square no WPForms

Observação: Para integrações de pagamento do WPForms, o modo de Teste e o modo Ao Vivo são configurados separadamente. Se você já configurou o Square para transações ao vivo via WPForms, precisará reconectá-lo no Modo de Teste.

Em seguida, clique no botão Conectar com Square.

Conectando o WPForms a uma conta de teste do Square

Observação: Se você não iniciou o painel da sua Conta de Teste Sandbox antes de tentar conectá-lo ao WPForms, verá uma mensagem de erro ao clicar no botão Conectar ao Square nas configurações de pagamentos do WPForms.

Consulte a seção de Perguntas Frequentes abaixo para mais detalhes.

Isso o levará a uma tela onde você precisará fazer login na sua conta do Square.

Entrando no Square para conectar sua conta de teste ao WPForms

Depois de fazer login, o Square solicitará que você conceda permissão ao WPForms para acessar certas informações em sua conta do Square. Clique no botão Permitir para continuar.

Permitindo que o WPForms acesse o Square

Isso o retornará às suas configurações do WPForms. Se a conexão foi bem-sucedida, você deverá ver uma marca de verificação verde ao lado de Status da Conexão e um aviso de que sua conta do Square está conectada no modo Sandbox.

Uma conexão sandbox do Square bem-sucedida nas configurações do WPForms

Criando um Formulário para Testar Pagamentos do Square

Assim que sua conta de Desenvolvedor do Square e as configurações do WPForms estiverem prontas, você precisará de um formulário que possa usar para testar pagamentos do Square. Crie um novo formulário ou edite um existente para abrir o construtor de formulários.

Você pode personalizar este formulário como desejar, mas certifique-se de incluir um campo Square. Você pode clicar neste campo no lado esquerdo do construtor ou arrastá-lo e soltá-lo na área de visualização para adicioná-lo ao seu formulário.

Adicionando um campo Square a um formulário

O campo Square permitirá que você insira informações de cartão de crédito de teste para garantir que os pagamentos estejam funcionando como esperado.

Ativando Pagamentos do Square em seu Formulário

Você também precisará habilitar os pagamentos do Square para o formulário que estará testando. No construtor de formulários, vá para Pagamentos » Square. Em seguida, ative a opção Habilitar pagamentos únicos para a posição ligada.

Habilitar pagamentos únicos Square

Isso revelará algumas configurações adicionais. Insira uma Descrição do Pagamento para ajudar a identificar esta transação em seu painel do Desenvolvedor Square mais tarde.

Campo de descrição de pagamento Square

O restante das configurações é opcional. Cobrimos elas com mais detalhes em nosso tutorial sobre como habilitar transações Square em tempo real no WPForms.

Configure as outras opções se desejar e salve seu formulário.

Para um exemplo completo, confira nosso Modelo de Formulário Calculadora de Taxas Square, que demonstra como configurar um formulário com integração Square, incluindo cálculos de taxas e informações detalhadas do pedido.

Publicando seu Formulário e Realizando o Teste

Quando seu formulário estiver pronto, você poderá testar os pagamentos Square no frontend do seu site. Para fazer isso sem publicar seu formulário em uma página ativa, você pode usar a opção de visualização de formulário no WPForms ou criar uma página ou post privado.

Em seguida, basta enviar uma entrada de teste para o seu formulário usando um dos conjuntos de dados de cartão de crédito de teste do Square.

Visualizando Transações de Teste no WPForms

Para visualizar e gerenciar todas as transações de teste e seus detalhes, basta ir em WPForms » Pagamentos e ativar a opção Dados de Teste.

visualizando-dados-teste-pagamentos

Para detalhes completos sobre como visualizar informações de pagamentos de teste e em tempo real, entender tendências de transações, ajustar para diferentes moedas e muito mais, confira nosso guia sobre visualização e gerenciamento de pagamentos.

Observação: Procurando oferecer descontos aos seus clientes por meio de códigos de cupom? Confira nosso tutorial do addon de Cupons para todos os detalhes.

Visualizando Transações de Teste em sua Conta Square

Após enviar seu pagamento de teste, você pode visualizar a transação em sua conta Square clicando no ID da Transação em sua entrada de teste ou fazendo login no Square Developer.

Certifique-se de conferir nosso guia sobre visualização e gerenciamento de pagamentos de formulários para mais informações.

Em sua conta do Desenvolvedor Square, clique no botão Painel Square para a Conta de Teste Padrão para abrir seu painel.

Clique em Painel Square para abrir o painel sandbox

Em seguida, vá para Pagamentos e faturas » Transações no menu à esquerda.

Você deverá ver sua transação de teste listada na tela seguinte.

Uma transação de teste em um painel sandbox do Square

Observação: Quando terminar de testar os pagamentos Square, lembre-se de desconectar sua conta de teste em WPForms » Configurações » Pagamentos, desativar o Modo de Teste e conectar sua conta de Vendedor ativa para que você possa processar as transações dos usuários.

Perguntas Frequentes

Abaixo, respondemos a algumas das principais perguntas sobre como testar pagamentos Square no WPForms.

Quando tento me conectar à minha conta Square no Modo de Teste, recebo um erro. Como posso corrigi-lo?

Ao tentar conectar sua conta do Desenvolvedor Square ao WPForms no Modo de Teste, você pode receber um erro que diz: “Erro: Para iniciar o fluxo Oauth para uma conta sandbox, primeiro inicie a conta de teste do vendedor no Painel do Desenvolvedor.”

Um erro de fluxo Oauth no Square

Para corrigir isso, abra sua conta do Desenvolvedor Square. Para a Conta de Teste Sandbox que você deseja usar, clique no botão Painel Square.

Clique em Painel Square para abrir o painel sandbox

Isso deve iniciar a conta de teste e abrir um painel de sandbox como este.

Um painel de Vendedor Sandbox do Square Developer

Assim que esta página for aberta, volte às suas configurações do WPForms e clique em Conectar com Square novamente.

Posso testar a verificação de cartões de crédito da UE para pagamentos Square feitos através dos meus formulários?

Sim, você pode testar a verificação de cartões de crédito da UE para pagamentos Square no WPForms.

Para fazer isso, você precisa configurar uma Conta de Teste Sandbox Europeia em seu painel do Square Developer. Em suas Contas de Teste Sandbox existentes, clique em Nova conta de teste sandbox.

Nova conta de teste sandbox

Na janela pop-up que aparece, nomeie esta Conta de Teste Sandbox e selecione um país da UE (Irlanda ou Espanha) no menu suspenso.

Selecionando um país da UE para uma Conta de Teste Sandbox do Square

Você pode então conectar esta conta de teste ao WPForms seguindo as etapas acima. Ao testar pagamentos em seu formulário, use um dos cartões de crédito da UE da lista de detalhes de pagamento de teste do Square.

Em seguida, quando você enviar o formulário, uma janela pop-up deverá aparecer solicitando o código de verificação adicional.

A janela pop-up de verificação para pagamentos UE do Square

Insira o código de teste fornecido pelo Square para concluir o pagamento de teste.

Por que vejo o erro 'Falha na tokenização do cartão de pagamento' ao enviar um pagamento de teste?

O erro de tokenização do cartão de pagamento ocorre se você tentar enviar um pagamento de teste usando detalhes reais do cartão de crédito. Quando isso acontece, o token necessário para processar o pagamento de teste será inválido. Para corrigir este erro, certifique-se de que está usando um dos cartões de crédito sandbox do Square para o seu pagamento de teste.

É isso! Agora você sabe como testar pagamentos Square no WPForms.

Em seguida, não se esqueça de realizar um teste completo do formulário antes de publicá-lo em seu site. Nosso checklist completo de teste de formulário o guiará pelo processo passo a passo.

O Melhor Plugin Construtor de Formulários de Arrastar e Soltar para WordPress

Fácil, Rápido e Seguro. Junte-se a mais de 6 milhões de proprietários de sites que confiam no WPForms.