iugu php

Perkenalan

Lib ini dibangun untuk membuatnya fleksibel, sehingga setiap orang dapat menggunakan semua fitur dari semua versi API.

Anda dapat mengakses dokumentasi resmi IUGU dengan mengakses tautan ini.

Indeks

• Instalasi
• Pengaturan
• Pelanggan
  • Membuat pelanggan
  • Pelanggan yang kembali
  • Mengembalikan pelanggan
• Token dan koleksi langsung
  • Membuat token
  • Koleksi Langsung
• Faktur
  • Membuat faktur
  • Mengembalikan faktur
  • Mengembalikan faktur

Instalasi

Instal perpustakaan menggunakan perintah

composer require igorsamaral/iugu-php

Pengaturan

Untuk memasukkan perpustakaan dalam proyek Anda, lakukan saja hal berikut:

 <?php

require __DIR__ . " /vendor/autoload.php "

$ iugu = new IuguClient( " SUA_CHAVE_DE_API ");

Mendefinisikan header khusus

1. Jika perlu dimungkinkan untuk mendefinisikan header khusus HTTP untuk permintaan tersebut. Untuk melakukan ini hanya memberi tahu mereka selama instantiasi objek Client :

 <?php

require __DIR__ . " /vendor/autoload.php "

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

Dan kemudian, Anda dapat menggunakan pelanggan untuk membuat permintaan ke yugu.com.br, seperti pada contoh di bawah ini.

Pelanggan

Pelanggan mewakili pengguna toko Anda, atau bisnis. Objek ini berisi informasi tentang mereka, seperti nama, email dan telepon, dan bidang lainnya.

Membuat pelanggan

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

Pelanggan yang kembali

 <?php

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

Mengembalikan pelanggan

 <?php

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

Token dan covement langsung

Token adalah representasi pembayaran pelanggan (misalnya kartu kredit Anda), sepenuhnya aman, sehingga tidak mungkin bagi seseorang untuk mendapatkan informasi kartu kredit pelanggan menggunakan token ini. Token dihasilkan untuk transaksi tertentu, membuatnya lebih aman.

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

Koleksi Langsung

Biaya sederhana melalui tiket atau kartu kredit.

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

Faktur

Membuat faktur untuk pelanggan.

Membuat faktur

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

Mengembalikan faktur

 <?php

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

Mengembalikan faktur

 <?php

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