iugu php

Einführung

Diese Lib wurde eingebaut, um sie flexibel zu machen, damit jeder alle Funktionen aller API -Versionen verwenden kann.

Sie können auf die offizielle Dokumentation von Iugu zugreifen, indem Sie auf diesen Link zugreifen.

Index

• Installation
• Einstellungen
• Kunden
  • Erstellen eines Kunden
  • Kunden zurückkehren
  • Einen Kunden zurückgeben
• Token und direkte Sammlung
  • Token erstellen
  • Direkte Sammlung
• Rechnungen
  • Erstellen einer Rechnung
  • Rendite Rechnungen
  • Eine Rechnung zurückgeben

Installation

Installieren Sie die Bibliothek mit dem Befehl

composer require igorsamaral/iugu-php

Einstellungen

Um die Bibliothek in Ihr Projekt aufzunehmen, machen Sie einfach Folgendes:

 <?php

require __DIR__ . " /vendor/autoload.php "

$ iugu = new IuguClient( " SUA_CHAVE_DE_API ");

Definieren von benutzerdefinierten Headern

1. Bei Bedarf ist es möglich, HTTP -angepasste Header für die Anfragen zu definieren. Um dies einfach zu tun, informieren Sie sie einfach während der Instanziierung des Client :

 <?php

require __DIR__ . " /vendor/autoload.php "

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

Und dann können Sie den Kunden verwenden, um Anfragen an yugu.com.br wie in den folgenden Beispielen zu stellen.

Kunden

Kunden vertreten Benutzer Ihres Geschäfts oder Geschäftstätigkeit. Dieses Objekt enthält Informationen zu ihnen, z. B. Name, E -Mail und Telefon sowie andere Felder.

Erstellen eines Kunden

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

Kunden zurückkehren

 <?php

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

Einen Kunden zurückgeben

 <?php

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

Token und Direktverletzungen

Token ist eine Kundenzahlung (z. B. Ihre Kreditkarte), so dass es nicht möglich ist, dass jemand Kundendaten mit diesem Token erhalten. Das Token wird für eine bestimmte Transaktion erzeugt, was es noch sicherer macht.

Ein Token erstellen

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

Direkte Sammlung

Einfache Gebühr per Ticket oder Kreditkarte.

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

Rechnungen

Erstellt eine Rechnung für einen Kunden.

Erstellen einer Rechnung

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

Rendite Rechnungen

 <?php

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

Eine Rechnung zurückgeben

 <?php

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