Essa Lib foi construída com o intuito de torná-la flexível, de forma que todos possam utilizar todas as features, de todas as versões de API.
Você pode acessar a documentação oficial da Iugu acessando esse link.
Instale a biblioteca utilizando o comando
composer require igorsamaral/iugu-php
Para incluir a biblioteca em seu projeto, basta fazer o seguinte:
<?php
require __DIR__ . "/vendor/autoload.php"
$iugu = new Iugu\Client("SUA_CHAVE_DE_API");- Se necessário for é possível definir headers http customizados para os requests. Para isso basta informá-los durante a instanciação do objeto
Client:
<?php
require __DIR__ . "/vendor/autoload.php"
$iugu = new iugu\Client(
"SUA_CHAVE_DE_API",
["headers" => ["MEU_HEADER_CUSTOMIZADO" => "VALOR HEADER CUSTOMIZADO"]]
); E então, você pode poderá utilizar o cliente para fazer requisições ao Iugu.com.br, como nos exemplos abaixo.
Clientes representam os usuários de sua loja, ou negócio. Este objeto contém informações sobre eles, como nome, e-mail e telefone, além de outros campos.
<?php
$customer = $iugu->customers()->create([
"email" => "[email protected]",
"name" => "João das Neves",
"notes" => "lorem...",
"phone" => "999999999",
"phone_prefix" => "11",
"cpf_cnpj" => "11743685009",
"zip_code" => "76814112",
"number" => "100",
"street" => "Rua Cabedelo",
"city" => "Porto Velho",
"state" => "RO",
"district" => "Marcos Freire",
"complement" => "complemento...",
"custom_variables" => [
"key" => "value"
]
]);<?php
$customers = $iugu->customers()->getList();<?php
$customer = $iugu->customers()->get([
"id" => "ID_DO_CLIENTE"
]);O Token é uma representação do meio de pagamento do cliente (por ex: seu cartão de crédito), sendo totalmente seguro, de forma que não é possível que alguém consiga as informações do cartão de crédito do cliente utilizando esse token. O token é gerado para uma transação específica, tornando-o ainda mais seguro.
<?php
$token = $iugu->paymentToken()->create([
"account_id" => "ID_DA_SUA_CONTA_IUGU",
"customer_id" => "ID_DO_CUSTOMER",
"method" => "credit_card",
"data" => [
"number" => "4242424242424242",
"verification_value" => "648",
"first_name" => "João",
"last_name" => "das Neves",
"month" => "01",
"year" => "2023"
],
"test" => true,
]);Cobrança simples via boleto ou cartão de crédito.
<?php
$charge = $iugu->charges()->create([
"token" => "ID_DO_TOKEN_DE_PAGAMENTO_CRIADO",
"customer_id" => "ID_DO_CUSTOMER",
"total" => 10000,
"payer" => [
"cpf_cnpj" => "84752882000",
"name" => "João das Neves",
"address" => [
"zip_code" => "72917210",
"number" => "100"
]
],
"items": [
[
"description" => "Descrição do item 1",
"quantity" => 1,
"price_cents" => 10000
]
]
]);Cria uma fatura para um cliente.
<?php
$invoice = $iugu->invoices()->create([
"email" => "[email protected]",
"due_date" => "2021-07-21",
"items" => [
[
"description" => "Descrição do item 1",
"quantity" => 1,
"price_cents" => 10000
]
],
"total" => 10000,
"payer" => [
"cpf_cnpj" => "84752882000",
"name" => "João das Neves",
"address" => [
"zip_code" => "72917210",
"number" => "100"
]
]
]);<?php
$invoices = $iugu->invoices()->getList();<?php
$invoice = $iugu->invoices()->get([
"id" => "ID_DA_FATURA"
]);
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent