ecommpay/paymentpage-sdk

此包的最新版本(1.5.0)没有可用的许可信息。

Ecommpay SDK

1.5.0 2024-08-08 09:40 UTC

This package is auto-updated.

Last update: 2024-09-08 10:20:30 UTC


README

Build Status Test Coverage Maintainability

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

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

支付流程

Payment flow

安装

使用Composer安装

composer require ecommpay/paymentpage-sdk

获取支付URL

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

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

如果您想使用另一个域名作为URL,您可以通过可选的Gate构造函数参数来更改它

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

或使用方法更改它

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

处理来自Ecommpay的回调

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

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

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

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

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

待办事项

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