h2akim/senangpay-php

SenangPay Payment Gateway PHP Library (unofficial)

v2.0.0 2026-05-17 05:45 UTC

Requires

• php: ^8.2
• json-mapper/json-mapper: ^2.22
• laravie/codex: ^6.2
• laravie/codex-filter: ^2.1
• symfony/http-client: ^7.2

Requires (Dev)

• php-http/guzzle7-adapter: ^1.1
• phpunit/phpunit: ^10.5

MIT

• Hakim Razalan

README

Installation

composer require php-http/guzzle7-adapter h2akim/senangpay-php

HTTP Adapter

Refer PHP-HTTP Clients & Adapters for other supported clients and adapters.

Get Started

Creating client

use SenangPay\Client;
use SenangPay\Config;
use Laravie\Codex\Discovery;

$http = Discovery::client();

// OpenApi — payment URL creation + callback verification
$openApi = Client::makeOpenApi($http, new Config(
    merchantId: 'your_merchant_id',
    secretKey: 'your_secret_key',
));

// ApiV1 — query order/transaction status
$apiV1 = Client::makeApiV1($http, new Config(
    merchantId: 'your_merchant_id',
    secretKey: 'your_secret_key',
));

// Direct — client session + FPX bank list (Basic Auth)
$direct = Client::makeDirect($http, new Config(
    merchantId: 'your_merchant_id',
    secretKey: 'your_secret_key',
));

// Refund — get token → create refund (Bearer token)
$refund = Client::makeRefund($http, new Config(
    merchantId: 'your_merchant_id',
    secretKey: 'your_secret_key',
));

// Payout — submit payout (Basic Auth + SHA256)
$payout = Client::makePayout($http, new Config(
    merchantId: 'your_merchant_id',
    secretKey: 'your_secret_key',
));

// Tokenisation — token pay/updateStatus/validate
$tokenisation = Client::makeTokenisation($http, new Config(
    merchantId: 'your_merchant_id',
    secretKey: 'your_secret_key',
));

// Recurring — create recurring product (Basic Auth)
$recurring = Client::makeRecurring($http, new Config(
    merchantId: 'your_merchant_id',
    secretKey: 'your_secret_key',
));

Config

use SenangPay\Config;

// Default (production, hash md5)
$config = new Config(
    merchantId: 'xxx',
    secretKey: 'xxx',
);

// Sandbox + SHA256
$config = new Config(
    merchantId: 'xxx',
    secretKey: 'xxx',
    hashType: 'sha256',
    sandbox: true,
);

// Custom version
$config = new Config(
    merchantId: 'xxx',
    secretKey: 'xxx',
    version: 'v1',
);

// Custom base URI (overrides all defaults)
$config = new Config(
    merchantId: 'xxx',
    secretKey: 'xxx',
    baseUri: 'https://custom.example.com',
);

Use Sandbox

Set sandbox: true in Config to use sandbox endpoints. Domains with sandbox support:

Domain	Sandbox URL
OpenApi	https://sandbox.senangpay.my
ApiV1	https://sandbox.senangpay.my/apiv1
Direct	https://api.sandbox.senangpay.my
Refund	https://api.sandbox.senangpay.my
Payout	https://api.sandbox.senangpay.my
Recurring	https://api.sandbox.senangpay.my/recurring

Tokenisation does not support sandbox.

Domains

Domain	Description	Resource
OpenApi	Payment URL creation & callback verification	$openApi->payment()
ApiV1	Order/transaction status queries	$apiV1->order(), ->transaction(), ->transactions()
Direct	Client session & FPX bank list	$direct->payment(), ->fpxBank()
Refund	Token-based refunds	$refund->refund()
Payout	Merchant payout submissions	$payout->payout()
Tokenisation	Token pay, status update, validation	$tokenisation->token()
Recurring	Recurring product creation	$recurring->product()

License

MIT