README

此库为PHP应用程序提供与Payscel支付网关交互的简单接口。

使用Composer安装

composer require unityarray/payscel

用法

实例化Payscel类

require_once 'vendor/autoload.php';

use UnityArray\Payscel\Payscel;

$apiKey = 'YOUR_API_KEY';
$linkId = 'YOUR_LINK_ID';
$payscel = new Payscel($apiKey, $linkId);

发起支付

$msisdn = '254712345678'; // Phone number without the leading '+'
$amount = 10; // Amount in kes
$callback = 'https://your-website.com/callback'; // Your callback URL

$response = $payscel->initiate($msisdn, $amount, $callback);

// Handle the response (usually a JSON object containing checkout details)

// {
//   +"MerchantRequestID": "db57-40e1-af85-2424fab5a2e697902622"
//   +"CheckoutRequestID": "ws_CO_21032024215003724757869730"
//   +"ResponseCode": "0"
//   +"ResponseDescription": "Success. Request accepted for processing"
//   +"CustomerMessage": "Success. Request accepted for processing"
// }

// example 

echo $response->ResponseDescription; // Success. Request accepted for processing

查询支付状态

$checkoutId = 'CHECKOUT_ID_FROM_INITIATE_RESPONSE';

$response = $payscel->query($checkoutId);

// Handle the response (usually a JSON object containing payment status)

// {
//   +"ResponseCode": "0"
//   +"ResponseDescription": "The service request has been accepted successsfully"
//   +"MerchantRequestID": "847c-4573-85db-96a68dacad1992169467"
//   +"CheckoutRequestID": "ws_CO_21032024213641597757869730"
//   +"ResultCode": "1037"
//   +"ResultDesc": "DS timeout user cannot be reached"
// }

// example

echo $response->ResultDesc; // DS timeout user cannot be reached

方法

• initiate($msisdn, $amount, $callback): 发起支付。
• query($checkoutId): 查询支付状态。

示例

请参阅示例目录以获取更详细的用法示例。

贡献

我们欢迎贡献！请参阅CONTRIBUTING.md文件以获取更多信息。

许可证

此库采用MIT许可证。有关更多信息，请参阅LICENSE文件。