Integração do Cobre Grátis com o WooCommerce
PHP JavaScript
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
includes
languages
.editorconfig
.gitignore
Gruntfile.js
LICENSE.txt
README.md
cobregratis-woocommerce.php
package.json
readme.txt
screenshot-1.png

README.md

Cobre Grátis WooCommerce

Contributors: claudiosanches
Tags: checkout, billet, boleto, cobregratis
Requires at least: 3.5
Tested up to: 4.0
Stable tag: 1.0.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Start getting money by bank billet in your checking account using Cobre Grátis

Description

Description (en):

Start getting money by bank billet in your checking account using Cobre Grátis.

Descrição (pt_BR):

Comece a receber dinheiro por boleto bancário direto na sua conta corrente usando o Cobre Grátis. Sem limites e sem taxa por boleto.

Como Funciona o Boleto Bancário

[youtube http://www.youtube.com/watch?v=XhCMJ6CpD4M]

O Boleto Bancário é uma forma de pagamento exclusiva do Brasil. Qualquer pessoa física ou jurídica pode cobrar através de boletos bancários. Basta ter uma conta bancária e contratar uma carteira de cobrança junto ao banco. Aprenda mais como funciona, o que é Cedente, Sacado e o que você precisa para começar a cobrar seus clientes por Boleto Bancário.

Integração

A integração é completa para vender por boleto e ainda conta com sistema de retorno que avisa quando o boleto é pago, atualizando o status do seu pedido para processando.

É possível integrar com os seguintes bancos:

  • Banco do Brasil
  • Banespa
  • Banrisul
  • Santander
  • Sicredi
  • Real
  • Itaú
  • Bradesco
  • HSBC
  • Caixa Econômica Federal
  • Nossa Caixa
  • BCN
  • Sudameris
  • FINASA
  • Unibanco
  • Safra
  • Citibank
  • Bancoob/Sicoob

Instalação

Instalar é bem simples, basta seguir o nosso guia de instalação.

Compatibilidade

Compatível com as versões 2.0.x e 2.1.x do WooCommerce.

Dúvidas?

Você pode esclarecer suas dúvidas usando:

Coloborar

Você pode contribuir com código-fonte em nossa página no GitHub.

Installation

Instalação do plugin

  • Faça upload dos arquivos do plugin para a sua pasta de plugins ou faça a instalação usando o instalador do WordPress em Plugins > Adicionar Novo;
  • Ative o plugin.

Configuração do Cobre Grátis

  1. Crie uma conta e contrate um Plano Pago no Cobre Grátis;
  2. Com a conta é possível gerar um Token em Cobre Grátis - Minhas informações;
  3. E finalmente crie uma notificação em Cobre Grátis - Notificações;
  4. Na notificação criada:;
  5. Escolha o evento 'Pago';
  6. Escolha a situação 'Ativo';
  7. Crie um Código de Segurança;
  8. E configure a URL para notificação como por exemplo http://seusite.com.br/?wc-api=WC_Cobregratis_Gateway;
  9. Pronto, conta configurada.

Configuração do plugin

  1. Vá até WooCommerce > Configurações > Finalizar compra > Cobre Grátis;
  2. Habilite o Cobre Grátis e preencha como preferir as opções de Título de Descrição;
  3. Digite o token gerado na sua conta do Cobre Grátis;
  4. Por final preencha também a opção Código de segurança da notificação;
  5. Salve as configurações;
  6. Vá até WooCommerce > Configurações > Produtos > Inventário;
  7. Deixe em branco a opção Manter estoque (minutos) (isso evita problemas com contas canceladas antes do cliente pagar o boleto).
  8. Salve novamente as configurações;
  9. Tudo pronto para receber pagamentos via boleto bancário usando o Cobre Grátis.

Frequently Asked Questions

O que eu preciso para utilizar este plugin?

  • Ter instalado o WooCommerce 2.0.x ou superior.
  • Com a conta é possível gerar um Token em Cobre Grátis - Minhas informações;
  • E finalmente crie uma notificação em Cobre Grátis - Notificações;
  • Na notificação criada:;
  • Escolha o evento 'Pago';
  • Escolha a situação 'Ativo';
  • Crie um Código de Segurança;
  • E configure a URL para notificação como por exemplo http://seusite.com.br/?wc-api=WC_Cobregratis_Gateway;
  • Pronto, conta configurada.

O que é o Cobre Grátis?

O Cobre Grátis é um sistema que funciona na web, feito para que qualquer pessoa possa gerar boletos bancários e gerenciar suas cobranças. Com o Cobre Grátis é possível cadastrar os dados da cobrança que ele gera o boleto bancário para ser enviado para o cliente pagar. Os bancos possuem seus próprios sistemas para isso, mas no Cobre Grátis é possível emitir boletos para diversos bancos e gerenciar todas as cobranças em um só lugar. Além de possuir diversos recursos que outros sistemas não oferecem.

Quais são os pré-requisitos para usar o Cobre Grátis?

Para usar o Cobre Grátis é necessário:

  1. Ter uma conta corrente em banco;
  2. Possuir um contrato de cobrança (chamada de carteira de cobrança);
  3. Ter em mãos os dados da conta corrente e os dados da carteira de cobrança;
  4. Possuir um computador com acesso à internet;

Quais os bancos e carteiras suportadas?

  • Banco do Brasil - 18-17, 18-027, 17-019, 18-019 (Convênio com 7 dígitos), 18-019 (Convênio com 6 dígitos), 18-019 (Convênio com 8 dígitos)
  • Banespa - 008
  • Banrisul - Cob. Direta
  • Santander - 102
  • Sicredi - A (Simples)
  • Real - 57
  • Itaú - 179, 175, 109, 174, 176, 178, 157
  • Bradesco - 06, 09, 25, 03
  • HSBC - CNR, CNR Fácil
  • Caixa Econômica Federal - SIGCB: 24 ou 02, SINCO, SR (80), SR (82), CR (90), SR5
  • Nossa Caixa - CIDENT
  • BCN - 1
  • Sudameris - Cobrança Simples
  • FINASA - 27
  • Unibanco - Cob Especial
  • Safra - 4
  • Citibank - 3 - Cobrança Comum, 4 - Cobrança de Seguro
  • Bancoob/Sicoob - 01, 02

Mais dúvidas de como funciona o Cobre Grátis?

Acesse a FAQ do Cobre Grátis.

For Developers

É possível usar qualquer um dos exemplos abaixo dentro do functions.php do seu tema ou criando um plugin (veja como em WordPress - Writing a Plugin).

Adicionar um ícone no método de pagamento:

/**
 * Adicionar um ícone para Cobre Grátis.
 *
 * @param  string $url String vazia.
 *
 * @return string      Link para o seu ícone.
 */
function custom_woocommerce_cobregratis_icon( $url ) {
    return 'link do ícone';
}

add_filter( 'woocommerce_cobregratis_icon', 'custom_woocommerce_cobregratis_icon' );

Alterar os parametros postados para o Cobre Grátis:

/**
 * Customizar os dados postados para o Cobre Grátis.
 *
 * @param  array    $data  Dados gerados pelo plugin.
 * @param  WC_Order $order Objeto que contém todas as informações do pedido.
 *
 * @return array
 */
function custom_woocommerce_cobregratis_billet_data( $data, $order ) {
    // aqui você pode trabalhar e alterar o array $data com o que desejar.
    // Api do Cobre Grátis: https://github.com/Cobre Grátis/cobregratis-api

    return $data;
}

add_filter( 'woocommerce_cobregratis_billet_data', 'custom_woocommerce_cobregratis_billet_data', 10, 2 );

Alterar as instruções do boleto na página de "obrigado" (thankyou page):

/**
 * Customizar as instruções sobre o boleto na página "obrigado".
 *
 * @param  string $message  Mensagem padrão do plugin.
 * @param  int    $order_id ID do pedido.
 *
 * @return string           Novas instruções.
 */
function custom_woocommerce_cobregratis_thankyou_page_instructions( $message, $order_id ) {
    return 'Novas instruções';
}

add_filter( 'woocommerce_cobregratis_thankyou_page_instructions', 'custom_woocommerce_cobregratis_thankyou_page_instructions', 10, 2 );

Alterar as instruções do boleto no e-mail:

/**
 * Customizar as instruções sobre o boleto no e-mail.
 *
 * @param  string   $message Mensagem padrão do plugin.
 * @param  WC_Order $order   Objeto que contém todas as informações do pedido.
 *
 * @return string            Novas instruções.
 */
function custom_woocommerce_cobregratis_email_instructions( $message, $order ) {
    return 'Novas instruções';
}

add_filter( 'woocommerce_cobregratis_email_instructions', 'custom_woocommerce_cobregratis_email_instructions', 10, 2 );

Alterar as instruções do boleto para pedidos que estão aguardando pagamento:

/**
 * Customizar as instruções do boleto para pedidos que estão aguardando pagamento.
 *
 * @param  string   $message Mensagem padrão do plugin.
 * @param  WC_Order $order   Objeto que contém todas as informações do pedido.
 *
 * @return string            Novas instruções.
 */
function custom_woocommerce_cobregratis_pending_payment_instructions( $message, $order ) {
    return 'Novas instruções';
}

add_filter( 'woocommerce_cobregratis_pending_payment_instructions', 'custom_woocommerce_cobregratis_pending_payment_instructions', 10, 2 );

Screenshots

1. Plugin Settings.

1. Plugin Settings.

Changelog

1.0.1 - 17/05/2014

  • Corrigida a geração de boletos.

1.0.0

  • Versão inicial.

Upgrade Notice

1.0.1

  • Corrigida a geração de boletos.

License

Cobre Grátis WooCommerce is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Cobre Grátis WooCommerce is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Cobre Grátis WooCommerce. If not, see http://www.gnu.org/licenses/.