README

Requisitos

PHP 5.3.3 ou superior; recomedado 5.4 ou superior; testado até 7.1.

Composer

Você pode instalar a biblioteca pelo Composer. Rode o seguinte comando:

composer require confianet/confianet-php

Para que a biblioteca seja carregada, use o autoload do Composer:

require_once('vendor/autoload.php');

Instalação manual

Se você não deseja utilizar o Composer, você pode ir para a página de releases e baixar a última versão da biblioteca. Em seguida, para utilizar a biblioteca em seu código, inclua o arquivo init.php.

require_once('/path/to/confianet-php/init.php');

Dependências

As seguintes dependências são necessárias para o funcionamento da biblioteca:

curl, apesar que você pode usar seu próprio cliente non-cURL se for de sua preferência
json
mbstring (Multibyte String)

Se você utiliza o Composer, todas estas dependências serão checadas automaticamente. Se você optar pela instalação manual, verifique que todas estas estensões estão disponíveis.

Começando

Um exemplo de uso da API:

\Confianet\Confianet::setApiKey('ak_dev_2140f55e3a52bf98eef45449f9a93e3d');

$transaction = \Confianet\Transaction::create(array(
  "status" => "pending",
  "order" => "02-42373208",
  "value" => 974489,
  "buyer" => array(
    "email" => "comprador@example.com"
  ),
  "items" => array(
    array(
      "name" => "Macbook Pro Retina MGX82BZ/A",
      "value" => 962400
    ),
    array(
      "name" => "Boneco Toy Story Buzz Lightyear",
      "value" => 8799
    )
  ),
  "shipment" => array(
    "method" => "PAC",
    "status" => "pending",
    "value" => 3290
  ),
  "payment" => array(
    "method" => "credit_card",
    "card_holder_name" => "Andre B Sanches",
    "first_digits" => 4929,
    "last_digits" => 944875
  ),
));

echo $transaction;

Documentação

Por favor, acesse https://docs.confianet.com.br para a documentação completa e atualizada.

Customizar timeout das requisições

Para modificar o timeout das requisições (tempo de conexão ou tempo total, em segundos), você terá que dizer ao cliente API para utilizar outro CurlClient que não seja o padrão. Você seta os timeouts neste CurlClient.

// configura o Curl client customizado
$curl = new \Confianet\HttpClient\CurlClient();
$curl->setTimeout(10); // padrão é \Confianet\HttpClient\CurlClient::DEFAULT_TIMEOUT
$curl->setConnectTimeout(5); // padrão é \Confianet\HttpClient\CurlClient::DEFAULT_CONNECT_TIMEOUT

echo $curl->getTimeout(); // 10
echo $curl->getConnectTimeout(); // 5

// utiliza o client customizado
\Confianet\ApiRequestor::setHttpClient($curl);

// use as funções da API como você usaria normalmente

confianet / confianet-php

Maintainers

Details