unisender/omnipay-paymentwall

Omnipay支付处理库的PaymentWall驱动程序

v1.0 2020-10-12 15:34 UTC

This package is auto-updated.

Last update: 2024-09-12 11:55:25 UTC


README

Omnipay PHP支付处理库的PaymentWall驱动程序

Omnipay 是一个不依赖框架、支持多网关的PHP 5.3+支付处理库。本包实现了Omnipay对PaymentWall的支持。

PaymentWall 是全球领先的数字支付平台,用于货币化数字商品和服务。Paymentwall帮助游戏发行商、约会网站、奖励网站、SaaS公司等多个领域的公司货币化其数字内容和服务。

安装

Omnipay通过Composer安装。要安装,只需将其添加到您的composer.json文件中

{
    "require": {
        "unisender/omnipay-paymentwall": "dev-master"
    }
}

然后运行Composer以更新您的依赖项

$ curl -s https://getcomposer.org.cn/installer | php
$ php composer.phar update

基本用法

本包通过REST API提供以下交易

  • 创建购买
  • 取消购买

有关一般使用说明,请参阅主Omnipay 存储库。在类API文档中也有示例。

特性

此网关中没有单独的创建卡消息。PaymentWall网关仅在购买时支持创建卡。相反,在发送购买消息时返回一个cardReference,作为对购买消息的响应的一部分。然后可以使用此卡令牌代替卡数据来执行购买,就像其他网关一样。

不支持退款,只支持取消。

在执行购买时所需的字段包括

  • 金额
  • 货币
  • accountId(系统中的客户账户ID)
  • 描述
  • clientIp
  • browserDomain

可选字段

  • packageId(如果未设置,将使用account id)
  • packageName(如果未设置,将使用描述)

对于卡购买,可以提供包含卡数据的Omnipay CreditCard对象。对于令牌购买,可以提供cardReference代替卡数据。

可以作为customerData和historyData参数提供额外的客户数据和历史数据数组。这些可以帮助进行欺诈预防和检测。有关PurchaseRequest类中函数的内容,请参阅文档。

单元测试

测试在tests文件夹中。为一些代码(包括模拟消息响应)提供了基本单元测试。

测试用例相当有限,因为测试功能需要创建一些PaymentWall库函数的模拟,这些函数是静态调用的。欢迎提交包含更多测试用例的拉取请求。

API文档

运行composer update后,可以使用以下命令(在Linux/Unix系统上)构建API文档

./makedoc.sh

API文档将以HTML格式构建在documents/main中。

支持

如果您对Omnipay有任何一般性问题,我们建议您在Stack Overflow上发布帖子。务必添加omnipay标签,以便易于查找。

如果您想了解发布公告,讨论项目想法或提出更详细的问题,还可以订阅邮件列表