README

A Laravel package for integrating Opn Payments (formerly Omise) using the omise-php SDK. This package provides a simple way to implement payments in your Laravel project with a ready-made payment form and automatic payment handling.

View Full Documentation

Installation

1. Install Package

composer require necessarylion/opn-payments-laravel

1. Generate vendor

php artisan vendor:publish --provider="OpnPayments\OpnPaymentsServiceProvider" --force

1. Run Migration

php artisan migrate

1. Register Event Listener (optional)

• Register OpnPaymentCompleted class in app/Providers/EventServiceProvider.php
  to handle your order, sending email etc...

public function boot()
{
    ...
    Event::listen(
        \OpnPayments\Events\OpnPaymentCompleted::class,
        [\App\Listeners\OpnPaymentHandler::class, 'handle']
    );
}

1. Add credentials in .env file

OPN_MODE=test  # test or live
OPN_TEST_PUBLIC_KEY=pkey_***
OPN_TEST_SECRET_KEY=skey_***
OPN_LIVE_PUBLIC_KEY=pkey_***
OPN_LIVE_SECRET_KEY=skey_***

• Make sure that APP_URL include port if you are running on port
• Example

APP_URL=http://localhost:8000

Create Charge

Create charge using redirect url function

$payload = new OpnPaymentsRedirectPayload();
$payload->amount = 1000;
$payload->currency = OpnPaymentsCurrency::THAILAND_BAHT;
$payload->cancelUri = 'http://localhost:8000';
$payload->redirectUri = 'http://localhost:8000';
$payload->orderId = Str::uuid();
$payload->locale = OpnPaymentsLocale::ENGLISH;
$payload->paymentMethods = OpnPayments::paymentMethods();

return redirect(OpnPayments::getRedirectUrl($payload)->authorized_uri);

Product List

If you want to show list of products in payment page, you can do as below.

$payload->metaData = [
    'product' => [
        'image' => 'https://placehold.jp/75767a/ffffff/150x150.png'
        'name' => 'I Phone',
        'quantity' => '1',
        'price' => '320000',
    ]
];

OR

$payload->metaData = [
    'products' => [
        [
            'image' => 'https://placehold.jp/75767a/ffffff/150x150.png'
            'name' => 'I Phone',
            'quantity' => '1',
            'price' => '320000',
        ]
    ]
];

Event Listener

Handle Completed Payment using OpnPaymentHandler Listener

in app/Listeners/OpnPaymentHandler.php, you can check the payment_successful status of payment attempt.
to handle order, sending email etc..

public function handle(OpnPaymentCompleted $event) {
    $attempt = $event->attempt;
    $charge = $event->charge;
    if ($attempt->payment_successful) {
        // handle payment success here
    } else {
        // handle payment failed here
    }
}

Scheduler

Register scheduler for pending charges.

This scheduler will get all pending charge from records withing 24 hours. Then it will fetch status from Opn API and update if success or failed.

In app/Console/Kernel.php inside schedule() function add below line.

$schedule->command('opn-payments-scheduler')->everyFiveMinutes();

Additional Functions

Contribute

Want to contribute? Great! Fork the repo and create PR to us.

Development Process

• In your Laravel project
• Create packages folder mkdir packages
• And clone our package git clone git@github.com:necessarylion/opn-payments-laravel.git

{
    ...
    "repositories": {
        "opn-payments-laravel" : {
            "type": "path",
            "url" : "packages/opn-payments-laravel",
            "options": {
                "symlink": true
            }
        }
    },
}

"require": {
    ...
    "necessarylion/opn-payments-laravel" : "@dev"
},

composer update