iugu php

Introducción

Esta lib se construyó para que sea flexible, para que todos puedan usar todas las características de todas las versiones de API.

Puede acceder a la documentación oficial de IUGU accediendo a este enlace.

Índice

• Instalación
• Ajustes
• Clientes
  • Creando un cliente
  • Clientes que regresan
  • Devolver un cliente
• Tokens y colección directa
  • Creando token
  • Colección directa
• Facturas
  • Creando una factura
  • Vueltas de devolución
  • Devolver una factura

Instalación

Instale la biblioteca usando el comando

composer require igorsamaral/iugu-php

Ajustes

Para incluir la biblioteca en su proyecto, simplemente haga lo siguiente:

 <?php

require __DIR__ . " /vendor/autoload.php "

$ iugu = new IuguClient( " SUA_CHAVE_DE_API ");

Definición de encabezados personalizados

1. Si es necesario, es posible definir los encabezados personalizados HTTP para las solicitudes. Para hacer esto, simplemente informarles durante la instancia del objeto Client :

 <?php

require __DIR__ . " /vendor/autoload.php "

$ iugu = new iuguClient(
    " SUA_CHAVE_DE_API ",
    [ " headers " => [ " MEU_HEADER_CUSTOMIZADO " => " VALOR HEADER CUSTOMIZADO " ]]
); 

Y luego, puede usar el cliente para hacer solicitudes a yugu.com.br, como en los ejemplos a continuación.

Clientes

Los clientes representan a los usuarios de su tienda o negocio. Este objeto contiene información sobre ellos, como nombre, correo electrónico y teléfono, y otros campos.

Creando un cliente

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

Clientes que regresan

 <?php

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

Devolver un cliente

 <?php

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

Tokens y covement directo

Token es una representación de pago del cliente (por ejemplo, su tarjeta de crédito), que está completamente segura, por lo que no es posible que alguien obtenga información de la tarjeta de crédito del cliente utilizando este token. El token se genera para una transacción específica, lo que lo hace aún más seguro.

Creando una 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 ,
]);

Colección directa

Cargo simple a través de boleto o tarjeta 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
        ]
    ]
]);

Facturas

Crea una factura para un cliente.

Creando una factura

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

Vueltas de devolución

 <?php

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

Devolver una factura

 <?php

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