Introdução

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.

Índice

• Instalação
• Configuração
• Clientes
  • Criando um cliente
  • Retornando clientes
  • Retornando um cliente
• Tokens e cobrança direta
  • Criando Token
  • Cobrança direta
• Faturas
  • Criando uma fatura
  • Retornando faturas
  • Retornando uma fatura

Instalação

Instale a biblioteca utilizando o comando

composer require igorsamaral/iugu-php

Configuração

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");

Definindo headers customizados

1. 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

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.

Criando um cliente

<?php

$customer = $iugu->customers()->create([
    "email" => "joao.neves@email.com",
    "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"
    ]
]);

Retornando clientes

<?php

$customers = $iugu->customers()->getList();

Retornando um cliente

<?php

$customer = $iugu->customers()->get([
    "id" => "ID_DO_CLIENTE"
]);

Tokens e cobraça direta

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.

Criando um token

<?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 direta

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
        ]
    ]
]);

Faturas

Cria uma fatura para um cliente.

Criando uma fatura

<?php

$invoice = $iugu->invoices()->create([
    "email" => "joao@email.com.br",
    "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"
        ]
    ]
]);

Retornando faturas

<?php

$invoices = $iugu->invoices()->getList();

Retornando uma fatura

<?php

$invoice = $iugu->invoices()->get([
    "id" => "ID_DA_FATURA"
]);