sapihost/paymentpage-sdk

1.0.0 2024-03-29 12:53 UTC

This package is not auto-updated.

Last update: 2024-10-01 07:14:36 UTC


README

Build Status

这是一套PHP语言库,用于简化您的服务与SapiHost支付页面的集成。

请注意,为了正确运行SDK,您至少需要PHP 7.0。

支付流程

Payment flow

安装

使用composer安装

composer require sapihost/paymentpage-sdk

获取支付URL

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

$url这里是指定的签名URL。

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

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

或者使用方法来更改它

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

处理来自SapiHost的回调

您需要自动加载此代码以处理通知

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

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

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

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

待办事项

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