hannanyusop/toyyibpay

Laravel 9 Package for ToyyibPay API (UPDATED)

v1.0.0 2022-05-08 16:44 UTC

README

For complete API usage, some endpoints need User Secret Key. For staging/testing purposes, please register an account at ToyyibPay Staging Portal. Here you can create dummy bills and make test payments via Bank Simulators.

Notification! We will not accept responsibility for loss of money due to improper use of the toyyibPay API and this package.

Installation

To install the package within your laravel project use the following composer command:

composer require hannanyusop/toyyibpay

Publish ToyyibPay Config File

php artisan vendor:publish --provider="Hannan\Toyyibpay\ToyyibpayServiceProvider"

Environment Credential Setup

TOYYIBPAY_USER_SECRET_KEY=ADD-TOYYIBPAY_USER_SECRET_KEY
TOYYIBPAY_REDIRECT_URI=ADD-TOYYIBPAY_REDIRECT_URI
TOYYIBPAY_SANDBOX=ADD-TOYYIBPAY_SANDBOX-MODE

Auto Discovery

If you're using Laravel 5.5+ you don't need to manually add the service provider or facade. This will be Auto-Discovered. For all versions of Laravel below 5.5, you must manually add the ServiceProvider & Facade to the appropriate arrays within your Laravel project config/app.php

Provider

Hannan\Toyyibpay\ToyyibpayServiceProvider::class,

Alias / Facade

'Toyyibpay' => Hannan\Toyyibpay\ToyyibpayFacade::class,

Usage

Use Toyyibpay Facade

use Toyyibpay;

class MyController extends Controller
{
  // Controller functions here...
}

Get Bank

Toyyibpay::getBanks();

Get Bank FPX

Toyyibpay::getBanksFPX();

Get Package

Toyyibpay::getPackages();

Create Category

Toyyibpay::createCategory($name, $description);

Get Category

Toyyibpay::getCategory($code);

Create Bill

Toyyibpay::createBill($code, $bill_object);

Get Bill Payment Link

Toyyibpay::billPaymentLink($bill_code);

Opening an Issue

Before opening an issue there are a couple of considerations:

  • You are all cute and geek!
  • Check that the issue is not specific to your development environment setup.
  • Provide duplication steps.
  • If you have a questions send me an email to tarmizi@mizi.my
  • Need a coach or assistance, I can do my best on Telegram: https://t.me/tarmizisanusi
  • Please be considerate that this is an open source project that I provide to the community for FREE.

License

Laravel Toyyibpay(the package) is licensed under the MIT license. Enjoy!