festpay/paymentpage-sdk

dev-main 2022-12-20 10:28 UTC

This package is auto-updated.

Last update: 2024-09-23 19:52:01 UTC


README

Build Status

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

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

支付流程

Payment flow

安装

使用composer安装

composer require festpay/paymentpage-sdk

获取支付URL

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

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

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

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

或者通过方法进行更改

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

处理FestPay回调

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

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

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

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

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

待办事项

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