Descrição
Adicione o Pagador da Braspag ao WooCommerce.
Braspag é um gateway de pagamento brasileiro.
Desenvolvimento
O plugin foi desenvolvido utilizando a documentação oficial sem nenhum suporte da Braspag.
Nenhum dos desenvolvedores possui vínculo com a Braspag ou com o WooCommerce.
Métodos de pagamento
- Boleto Bancário
- Cartão de Crédito
Compatibilidade
We tested this plugin against version 8.1+ of WooCommerce.
Esse plugin não requer Brazilian Market on WooCommerce mas sugere seu uso.
A Braspag só requerer o nome do comprador, porém mais alguns campos podem ser necessários para o antifraude e outras funcionalidades disponíveis.
Configuração
Após instalar o plugin, ative o método de pagamento e siga para as configurações.
- Ative a forma de pagamento.
- Dê um título e descrição para essa forma de pagamento.
- Adicione o “Merchant ID” fornecido pela Braspag.
- Marque a opção “Sandbox” se a loja não estiver em Produção (disponível para venda real).
- Adicione a “Secret Merchant Key” fornecida pela Braspag (observe que ela é diferente para Sandbox).
Após, ative os métodos de pagamento disponíveis.
Todas necessitam de um “Provider” fornecido pela Braspag e mais algumas configurações: leia as dicas (ícones com um ponto de interrogação) para mais informações.
Traduções
Você pode ajudar a traduzir Pagador (Braspag) para WooCommerce para o seu idioma.
Instalação
- Instale “Pagador (Braspag) para WooCommerce” na administração de plugins.
Ou
- Envie toda a pasta
woo-checkout-braspag
para a pasta/wp-content/plugins/
.
Então
- Ative o plugin no menu ‘Plugins’ do WordPress.
Perguntas frequentes
-
Funciona com o Gutenberg?
-
Sim. WooCommerce dá suporte ao WordPress 5+ e nós também.
-
Funciona com outro plugin de e-commerce?
-
Não. Essa é uma extensão do WooCommerce.
-
Não consigo adicionar um pagamento ao pedido na administração
-
Para criar um pagamento, na administração, você deve:
- Adicione um valor para “nome” nas informações de “faturamento”.
- Tenha certeza de que o pedido não está vazio e precisa de pagamento.
- Escolha Braspag como método de pagamento.
- ID da transação deve estar vazio.
-
ID da transação?
-
O ID de transação é o número da Braspag no seu pedido.
Se você já possui um ID da transação (pagamento feito na Braspag) você deve usar as ações do pedido para recuperar a informação da Braspag.
-
Meus pedidos não estão sendo atualizados automaticamente
-
Você deve configurar a URL que receberá notificações da Braspag.
Deve ser: “example.com/?wc-api=WC_Checkout_Braspag_Gateway”
Não esqueça de alterar “example.com” para a URL da sua página inicial.
-
Qual URL eu devo informar para receber as notificações POST da Braspag?
-
Dê uma olhada na pergunta anterior.
-
E sobre as carteiras virtuais?
-
Carteiras virtuais ainda estão em ALFA e não foram implementadas. O método de pagamento não irá aparecer na página de finalização de compra (nem na administração).
NÃO RECOMENDAMOS, mas você pode implementar por você mesmo:
Passo 1 – Crie sua implementação na interface como documentado pela carteira virtual.
Passo 2 – Use o filtro
wc_checkout_braspag_frontend_payment_methods
para permitir as carteiras na interface.Passo 3 – Crie e preencha inputs ocultos em
braspag/payment-methods/wl-form.php
com os dados recebidos pela e-wallet:- braspag_payment_wl_type: tipo da carteira virtual (segundo a documentação da Braspag: Wallet.Type).
- braspag_payment_wl_token: o token/código recebido da carteira virtual (iremos preencher o campo pedido pela Braspag de acordo com o tipo de carteira virtual – não existe nome padronizado).
- braspag_payment_wl_installments: parcelas do pagamento (segundo a documentação da Braspag, mas não temos certeza se pode ser diferente de 1).
Passo 4 – Certifique-se de que tudo está configurado nas configurações do WooCommerce (WalletKeys) e na Braspag (ambiente e credenciais de produção).
Se você quiser contribuir, um PR será bem-vindo!
-
Alterado número meu boleto
-
Nós enviávamos o “BoletoNumber” para a Braspag, mas esse campo não é obrigatório e pode causar problemas em alguns “providers”.
Por enquanto, nós decidimos remover o campo e permitir que desenvolvedores adicionem/alterem esse valor usando o filtro “wc_checkout_braspag_bank_slip_number”.
Isso não irá alterar nada na administração do WordPress.
-
O que é PHP?
-
É uma linguagem de progração para desenvolvimento web. O PHP, como qualquer software, possui versões. E damos suporte à versão 7 (e maiores).
Se você está usando uma versão anterior ao PHP 7, entre em contato com a sua hospedagem para atualizar seu ambiente.
-
Quem são os desenvolvedores?
-
- Mário Valney is a Brazilian developer who integrates the WordPress community.
-
Posso ajudá-los?
-
Yes! Visit GitHub repository.
Colaboradores e desenvolvedores
“Pagador (Braspag) para WooCommerce” é um programa de código aberto. As seguintes pessoas contribuíram para este plugin.
ColaboradoresPagador (Braspag) para WooCommerce” foi traduzido para 1 localidade. Agradecemos aos tradutores por suas contribuições.
Traduzir “Pagador (Braspag) para WooCommerce” para seu idioma.
Interessado no desenvolvimento?
Navegue pelo código, consulte o repositório SVN ou assine o registro de desenvolvimento por RSS.
Registro de alterações
4.0.2
- Minor fixes.
4.0.1
- Minor fixes.
4.0.0
- Support to PHP 8.2.
3.2.2
- Added ‘wc_checkout_braspag_update_order_from_payment_transaction’ filter.
- Added ‘is_processing_payment’ method on gateway to allow developers check the first transaction data.
- Added ‘get_recurrent_payment’ method in query requrests.
3.2.1
- Added API error messages when creating orders (‘WC_Checkout_Braspag_Messages::payment_error_message’ on ‘post_transaction’).
3.2.0
- Added ‘wc_checkout_braspag_payment_status’ filter.
- Added ‘wc_checkout_braspag_payment_status_note’ filter.
- Added ‘wc_checkout_braspag_payment_error_message’ filter.
- Added ‘wc_checkout_braspag_do_payment_request’ filter.
3.1.3
- Added a way to overwrite wallet key with front-end (e-wallet are still in BETA).
3.1.0
- Adicionada opção para enviar o nome da empresa no lugar do nome do comprador, se o CNPJ estiver cadastrado.
3.0.1
- Corrigido o método de salvar o CardToken.
3.0.0
É uma versão para desenvolvedores:
- Permite aos desenvolvedores criar pagamentos com uma array de dados de pagamento (ou pela API).
- Carteiras virtuas implementadas em BETA (sem interface no pagamento).
Para usuários:
- Algumas correções de tradução.
2.2.2
- Atualizados os Providers da Braspag.
2.1.1
- Corrigido o envio da identidade do usuário se tipo de pessoa não for enviado.
2.1.0
- Removido campo “BoletoNumber”.
- Filtros adicionados
2.0.1
- Correções da tradução
2.0.0
- Melhora as informações de pagamento do pedido.
- Adiciona validação do comprador na finalização do pedido.
- Permite aos desenvolvedores esconderem um método de pagamento na finalização do pedido.
- Permite criar um pagamento direto na administração dos pedidos.
1.4.0
- Adicionada informação de pagamento no pedido.
- Adicionado método para encontrar a bandeira do cartão de crédito.
- Removendo Cartão de Débito, já que não testamos.
1.3.3
- Adicionada informações de pagamento aos e-mails.
1.3.2
- Suporte a credenciais vazias, se já estiver configurado na Braspag.
1.3.1
- Suporte à Emissora.
1.3.0
- Corrigidos centavos do pedido e melhorada validação.
1.2.0
- Suporte a Safra
1.1.0
- Melhor organização dos arquivos.
- Adicionados métodos para trabalhar com ExtraDataCollection nas informações de pagamento.
1.0
- It’s alive!
- Receba pagamentos com a Braspag!