cynobit/crediborg-client

PHP library for consuming CrediBorg APIs

0.1.0 2020-07-22 21:43 UTC

Requires

• php: >=7.1.3
• mashape/unirest-php: 3.*

Requires (Dev)

• mikecao/flight: ^1.3
• phpunit/phpunit: ^8.2.3

MIT

• Francis Ilechukwu

• php
• payment
• invoice
• transfer
• crediborg
• cynobit

README

crediborg-php-client

PHP Client for the CrediBorg Service.

CrediBorg is a CREDIT Alert Processing Technology that listens for CREDIT Transaction Emails (Alerts) on your mailbox, processes them by extracting relevant information from it and running it accross customer generated invoices for a match and equally notifying your servers with relevant details via web hooks.

This is a PHP based Client Library to consume the Service (CrediBorg) APIs.

Go to for the full REST API documentation.

Installation

The CrediBorg PHP Client SDK is available on Packagist as cynobit/crediborg-client:

$ composer require cynobit/crediborg-client:dev-master

Usage

Create Invoice

$amount = 75000;

$secret = ".....";
$token = "...";

$invoice = new CrediBorg\Invoice($amount);

$invoice->setCode('AHYT645623')
    ->setEmail('[e-mail]');
    ->setCustomer([
        'first_name'  => 'John',
        'middle_name' => 'Alfred',
        'last_name'   => 'Doe'
    ])
    ->setMetaData([
        // Possible cart items or anything you want.
        'items' => [
            [
                'name'       => 'Raspberry Pi'
                'qty'        => 2,
                'unit_price' => 25000
            ],
            [
                'name'       => 'ESP32 Module'
                'qty'        => 20,
                'unit_price' => 2000
            ]
        ]
    ]);
$crediborg = new CrediBorg\CrediBorg($secret, $token);

$crediborg->createInvoice($invoice);

echo $invoice->getCode(); // Invoice Code

Handle Event Payload at Configured WebHook

$secret = ".....";
$token = "...";

$crediborg = new CrediBorg\CrediBorg($secret, $token);

$event = $crediborg->getEventPayload();

foreach ($event->getMatchedInvoices() as $invoice) {
    echo $invoice->code . PHP_EOL;
    foreach ($invoice->getMatchedTransactions() as $transaction) {
        echo $transaction->narration . PHP_EOL;
        echo $transaction->type . PHP_EOL;
        echo $transaction->amount . PHP_EOL;
    }
}