paytransferkz/paymentpage-sdk

1.0.0 2024-08-22 13:25 UTC

This package is auto-updated.

Last update: 2024-09-22 14:00:40 UTC


README

Build Status

这是一套PHP语言库,旨在简化您的服务与PaytransferKZ支付页面的集成。

请注意,为了正确使用SDK,您必须至少安装PHP 7.0。

支付流程

Payment flow

安装

使用composer安装

composer require paytransferkz/paymentpage-sdk

获取支付URL

$gate = new paytransferkz\Gate('secret');
$payment = new paytransferkz\Payment('11', 'some payment id');
$payment->setPaymentAmount(1000)->setPaymentCurrency('RUB');
$url = $gate->getPurchasePaymentPageUrl($payment);

这里的 $url 是已签名的URL。

如果您想使用其他域名的URL,可以通过可选的 Gate 构造函数参数进行更改

new paytransferkz\Gate('secret', 'https://mydomain.com/payment');

或使用方法进行更改

$gate->setPaymentBaseUrl('https://mydomain.com/payment');

处理来自paytransferkz的回调

为了处理通知,您需要自动加载此代码

$gate = new paytransferkz\Gate('secret');
$callback = $gate->handleCallback($data);

$data 是从支付系统接收到的JSON数据;

$callback 是描述从支付系统接收到的属性的回调对象;$callback 实现了以下方法

  1. Callback::getPaymentStatus(); 获取支付状态。
  2. Callback::getPayment(); 获取所有支付数据。
  3. Callback::getPaymentId(); 获取您系统中支付ID。

待办事项

  • 支付页面打开
  • 处理通知
  • 直接网关请求
  • PHPDoc