jeybin/networkintl is a wrapper package or in other words a helper package for implementing the Network International (NGENIUS) payment gateway in Laravel Projects.
- Easier create order
- Webhook helpers
Requires PHP v7.0+ to run. Install the jeybin/networkintl using the command
composer require jeybin/networkintlAfter installation publish the config and service providers using
php artisan ngenius:installOnce everything publishes, run the migration command to create the required tables
php artisan ngenius:migrateIf you want to copy the Job files from the package run the command below, this will create the Jobs files required for the webhook listener. (path : App\Jobs\NgeniusWebhooks)
php artisan ngenius:ngenius-webhooksOnce all the installation procedures are done there will be two tables available in your database one will be called as ngenius_gateway this table holds the configurations for the gateway
| Columns | Description |
|---|---|
| id | Auto increment value (Primary Key) of the table |
| active | 1 or 0 for assigning the active gateway if have multiple |
| type | The type of configuration, accepting values are live/sandbox |
| api_key | Api from network international |
| reference_id | Reference id from Network international |
| base_url | Api base url (different base urls in live and sandbox) |
Other table is ngenius_gateway_webhooks this table will save the data received in the webhook URL.
| Columns | Description |
|---|---|
| id | Auto increment value (Primary Key) of the table |
| event_id | Event id (payload->eventId) |
| event_name | Event name (payload->eventName) |
| order_reference | Order reference (payload->order->reference) |
| merchant_order_reference | Merchant order reference (payload->order->merchantOrderReference) |
| Email of the payer (payload->order->emailAddress) | |
| currency | Payment currency (payload->order->amount->currencyCode) |
| amount | Payment amount (payload->order->amount->amount) |
| payload | Full payload data received inside the webhook url in JSON format (payload) |
| exception | Save exception if any |
To create purchase order import use Jeybin\Networkintl\Ngenius to the class
Ngenius::type('create-order')
->request($paymentUrlRequest)
->execute()
->json()The payment request ($paymentUrlRequest) is an array with following keys.
| Key | Description |
|---|---|
| amount | Payment amount in merchant currency |
| payer_email | Email address of the payer |
| order_reference | Merchant order reference number |
| redirect_url | Redirection path once the payment is successed |
| cancel_url | Redirection path once the payment is cancelled |
| cancel_text | The text need to be shown in the cancel button |
| merchant_defined | Array of details you want like to pass like product name etc |
| language | Gateway language, default is English, allowed parameters en,ar and fr |
| billing | Required, Array of billing array details parameters are first_name, last_name , address,city,country |
| skip_confirmation_page | Boolean value, by default false |
| skip3DS | Boolean value, by default false |
To check the status of an order simply pass order-status as type with order reference number in the request
Ngenius::type('order-status')
->request('order-reference-number')
->execute()
->json();- Laravel Official Documentation
- Laravel Http Client
- Laravel Jobs
- Network International Payment Gateway Documentation
- Network International Payment Gateway Webhooks
MIT
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent