iugu php

Introduction

Cette lib a été construite afin de la rendre flexible, afin que tout le monde puisse utiliser toutes les fonctionnalités de toutes les versions API.

Vous pouvez accéder à la documentation officielle d'Iugu en accédant à ce lien.

Indice

• Installation
• Paramètres
• Clients
  • Créer un client
  • Clients de retour
  • Retourner un client
• Jetons et collection directe
  • Création de jeton
  • Collection directe
• Factures
  • Créer une facture
  • Factures de retour
  • Retourner une facture

Installation

Installez la bibliothèque à l'aide de la commande

composer require igorsamaral/iugu-php

Paramètres

Pour inclure la bibliothèque dans votre projet, faites ce qui suit:

 <?php

require __DIR__ . " /vendor/autoload.php "

$ iugu = new IuguClient( " SUA_CHAVE_DE_API ");

Définition des en-têtes personnalisés

1. Si nécessaire, il est possible de définir des en-têtes personnalisés HTTP pour les demandes. Pour ce faire, informez-les simplement lors de l'instanciation de l'objet Client :

 <?php

require __DIR__ . " /vendor/autoload.php "

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

Et puis, vous pouvez utiliser le client pour faire des demandes pour yugu.com.br, comme dans les exemples ci-dessous.

Clients

Les clients représentent des utilisateurs de votre magasin ou de votre entreprise. Cet objet contient des informations à leur sujet, tels que le nom, le courrier électronique et le téléphone, et d'autres champs.

Créer un client

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

Clients de retour

 <?php

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

Retourner un client

 <?php

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

Jetons et couvrement direct

Token est une représentation de paiement client (par exemple, votre carte de crédit), étant entièrement sûre, afin qu'il ne soit pas possible pour quelqu'un d'obtenir des informations sur la carte de crédit client en utilisant ce jeton. Le jeton est généré pour une transaction spécifique, ce qui le rend encore plus sûr.

Créer un jeton

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

Collection directe

Frais simples via un billet ou une carte de crédit.

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

Factures

Crée une facture pour un client.

Créer une facture

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

Factures de retour

 <?php

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

Retourner une facture

 <?php

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