Pagador (Braspag) para WooCommerce

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?

Posso ajudá-los?

Yes! Visit GitHub repository.

Avaliações

Leia a 1 avaliação

Colaboradores e desenvolvedores

“Pagador (Braspag) para WooCommerce” é um programa de código aberto. As seguintes pessoas contribuíram para este plugin.

Colaboradores

Pagador (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!