Biblioteca PHP

A Biblioteca de integração PHP consiste num diretório que deve ser copiado para o sistema onde a integração será feita. Desse diretório, dois arquivos serão incluídos no sistema de e-commerce:

  • pagamento.php – funções para enviar os dados da compra para o CobreDireto
  • retorno.php – funções para receber o retorno dos dados do CobreDireto, incluindo os procedimentos de receber a campainha e executar o probe.

Baixe a biblioteca

CobreDireto – Biblioteca PHP

Pré-requisitos

Para a biblioteca funcionar perfeitamente, estas bibliotecas devem estar habilitadas no seu php.ini.

Você pode fazer essa verificação usando o método phpinfo().

Enviando os dados da compra para o CobreDireto

Antes de começar, você precisa configurar a biblioteca para funcionar corretamente. Dentro do arquivo CD_config.php, você encontrará as seguintes constantes:

<?
// Ambiente de utilização do CobreDireto (producao,teste)
define('CD_AMBIENTE'    ,'teste');
// Código da loja junto ao CobreDireto
define('CD_CODLOJA'     ,'loja');
// Usuario no CobreDireto
define('CD_USUARIO'     ,'usuario');
// Senha no CobreDireto
define('CD_SENHA'       ,'senha');
// URL de Recibo
define('CD_URL_RECIBO'  ,'http://seu.dominio.com.br/recibo.php');
// URL em caso de erro
define('CD_URL_ERRO'    ,'http://seu.dominio.com.br/erro.php');
// URL de Retorno para o Bell e o Probe
define('CD_URL_RETORNO' ,'http://seu.dominio.com.br/retorno.php');
// Valor do Frete em inteiro
define('CD_FRETE'  	,0);

O envio dos dados da compra para o CobreDireto deve ser feito ao final do processo de compra. Você deve enviar os dados da compra (itens do pedidos, preço, quantidade, etc.).
Veja um exemplo de como enviar os dados:

<?
// Incluindo o arquivo da biblioteca
include('pagamento.php');
// Criando uma nova compra, já com o código do pedido
$pg=new Pg(123);
// Adicionando dois produto
$pg->adicionar(array(
  array(
    "descricao"=>"Descrição do Produto",
    "valor"=>12.90,
    "quantidade"=>1,
    "id"=>33
  ),
  array(
    "descricao"=>"Descrição do Produto 2",
    "valor"=>33.40,
    "quantidade"=>1,
    "id"=>35
  ),
));
// Cria a compra junto ao CobreDireto e redireciona o usuário
$pg->pagar();
?>

Neste exemplo, criamos uma nova compra, cujo ID em nossa loja é 123. Após a transação, o usuário será enviado para a URL definida no arquivo de configuração, em CD_URL_RECIBO. Se houver problemas com o pagamento, ele irá para CD_URL_ERRO. E o CobreDireto enviará o status da transação, sempre que houver modificações, para CD_URL_RETORNO.

Recebendo o retorno do CobreDireto

A biblioteca PHP cuida para você do processo de recebimento dos dados (incluindo os procedimentos de receber a Bell e obter o Probe). Dessa forma, você precisa se preocupar apenas com o que fazer com os dados. Veja um exemplo de código:

<?php
function capturar($codpedido, $status){
  // Aqui você tem o id do pedido, o valor e o status.
  // Confira o valor com o que você tem no seu banco de dados
  // e, se o status for 0, libere o pedido.
}
include('retorno.php');
?>

O parâmetro $codpedido é o ID que você passou para o CobreDireto ao criar o pagamento. $valor é o valor que foi pago, em reais e $status é o status do pagamento, conforme a tabela abaixo:

status descrição
0 Pago – transação OK
1 Não pago – transação cancelada ou inválida
2 Pendente – transação em análise ou não capturada

Atendimento