Configurando o plugin WooCommerce para pagamentos 4Geeks¶
Visão geral¶
O 4Geeks Payments WooCommerce Plugin permite que você aceite pagamentos online em sua loja WordPress/WooCommerce em 5 minutos ou menos - sem necessidade de codificação. Como comerciante oficial, a 4Geeks cuida da conformidade fiscal, prevenção de fraudes e estornos para que você possa se concentrar nas vendas.
Neste tutorial, você irá:
- Instale o plugin 4Geeks Payments
- Configurar métodos de pagamento
- Teste transações no modo sandbox
- Entre no ar e comece a aceitar pagamentos
Pré-requisitos¶
- Uma conta 4Geeks Payments ativada (ativar serviço)
- WordPress 5.0+ com WooCommerce instalado
- Acesso de administrador ao seu painel do WordPress
Etapa 1: Instale o plug-in¶
Opção A: Do diretório de plug-ins do WordPress¶
- Vá para o painel de administração do WordPress
- Navegue até Plugins → Adicionar Novo
- Pesquise “Pagamentos 4Geeks”
- Clique em “Instalar agora” e depois em “Ativar”
Opção B: upload manual¶
- Baixe o plugin em docs.4geeks.io/en/payments/plugins/woocommerce
- Vá para Plugins → Adicionar novo → Carregar plug-in
- Carregue o arquivo ZIP
- Clique em “Ativar”
Etapa 2: configurar chaves de API¶
- Vá para WooCommerce → Configurações → Pagamentos
- Encontre 4Geeks Payments e clique em “Gerenciar”
- Insira suas credenciais de API:
- Chave Pública: Do seu console 4Geeks
- Chave secreta: Do seu console 4Geeks
- Alterne “Ativar/Desativar” para Ativar
Dica: comece com chaves de sandbox para testar antes de ir ao ar.
Etapa 3: definir configurações de pagamento¶
Configurações Gerais¶
| Configuração | Descrição | Recomendado |
|---|---|---|
| Título | Nome da forma de pagamento mostrado na finalização da compra | “Cartão de Crédito/Débito” |
| Descrição | Descrição apresentada aos clientes | “Pague com segurança com seu cartão” |
| Modo de teste | Habilitar testes de sandbox | Sim (inicialmente) |
| 3D seguro | Habilitar autenticação 3DS | Sim |
Configurações de transação¶
| Configuração | Descrição | Recomendado |
|---|---|---|
| Captura | Captura automática ou autorização apenas | Captura automática |
| Descritor de declaração | Texto no extrato bancário do cliente | Nome da sua empresa |
| Cartões aceitos | Quais bandeiras de cartão aceitar | Todos habilitados |
Etapa 4: Teste no modo Sandbox¶
- Certifique-se de que Modo de teste esteja ativado
- Adicione um produto ao seu carrinho e prossiga para a finalização da compra
- Use um número de cartão de teste:
| Cartão | Número | Resultado |
|---|---|---|
| Visto (Sucesso) | 4242 4242 4242 4242 | Pagamento aprovado |
| Visto (recusado) | 4000 0000 0000 9995 | Pagamento recusado |
| Requer 3DS | 4000 0000 0000 0002 | Desafio 3D seguro |
- Use qualquer data de validade futura e qualquer CVC de 3 dígitos
- Conclua a finalização da compra e verifique o status do pedido
Etapa 5: verificar a configuração do webhook¶
Webhooks garantem que sua loja receba atualizações de pagamento em tempo real:
- No console 4Geeks, vá para Pagamentos → Configurações → Webhooks
- Adicione o URL do seu webhook:
https://yourstore.com/wc-api/4geeks_payments - Selecione eventos para receber:
carga.com sucessocarga.falhoureembolso.concluídosubscrição.criada- Salve e teste o webhook
Etapa 6: Transmissão ao vivo¶
Assim que o teste for concluído:
- Mude do Modo de teste para o Modo ao vivo nas configurações do plugin
- Substitua as chaves de API do sandbox por chaves de produção
- Faça um pedido de teste real com um cartão real (pequena quantia)
- Verifique se o pagamento aparece em seu console 4Geeks
- Confirme se o pagamento está agendado para sua conta bancária
Recursos suportados¶
| Recurso | Suportado |
|---|---|
| Pagamentos únicos | Sim |
| Assinaturas recorrentes (assinaturas WooCommerce) | Sim |
| Reembolsos do administrador WooCommerce | Sim |
| Reembolsos parciais | Sim |
| Multi-moeda | Sim |
| 3D Seguro (3DS) | Sim |
| Cartões salvos | Sim |
| Links de pagamento | Sim |
Solução de problemas¶
Problemas comuns¶
| Edição | Solução |
|---|---|
| Erro “Chave de API inválida” | Verifique se as chaves estão corretas e no ambiente certo (sandbox vs. produção) |
| O pagamento falha silenciosamente | Verifique a configuração do webhook e os logs do servidor |
| 3D Secure não aciona | Certifique-se de que o 3DS esteja habilitado nas configurações do plugin |
| Reembolso não processado | Verifique se a cobrança original foi capturada e reembolsável |
Obtendo ajuda¶
- Verifique os logs do plugin: WooCommerce → Status → Logs
- Revise a documentação de pagamentos
- Entre em contato com o suporte através do painel do console
O que vem a seguir?¶
- Saiba mais sobre Faturamento de assinatura recorrente
- Explore Check-out multimoedas
Precisa de ajuda?¶
- Documentação: docs.4geeks.io/en/payments/plugins/woocommerce
- Referência da API: docs.4geeks.io/en/api
- Suporte: disponível no painel do console
Ainda tem dúvidas? Pergunte na Discord or explore tutoriais