The Laravel SDK is available at OrcusHQ/orcuspay-laravel.

Requirements

  • PHP 8.1 or newer
  • Laravel 10, 11, or 12
  • Orcuspay access and secret keys

Install

composer require orcushq/orcuspay-laravel
If the package is not published to Packagist yet, install from GitHub:
composer config repositories.orcuspay-laravel vcs https://github.com/OrcusHQ/orcuspay-laravel
composer config repositories.orcuspay-php vcs https://github.com/OrcusHQ/orcuspay-php
composer require orcushq/orcuspay-laravel:dev-main

Publish config

php artisan vendor:publish --provider="OrcusPay\Laravel\OrcusPayServiceProvider"

Environment variables

ORCUSPAY_ACCESS_KEY=ak_test_xxxxx
ORCUSPAY_SECRET_KEY=sk_test_xxxxx
ORCUSPAY_API_URL=https://brain.orcuspay.com/api

Create a checkout session

use OrcusPay;

$session = OrcusPay::createCheckoutSession([
    'amount' => 10000,
    'currency' => 'BDT',
    'success_url' => route('payment.success'),
    'cancel_url' => route('payment.cancel'),
    'customer' => [
        'name' => 'Test Customer',
        'email' => 'customer@example.com',
        'phone' => '01700000000',
    ],
]);

Notes

  • Use ak_test_ and sk_test_ keys while developing.
  • Switch to ak_prod_ and sk_prod_ only after a successful test payment.
  • Never expose the secret key in frontend JavaScript.