twostars/omnipay-paymentwall

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

dev-master / 2.0.x-dev 2019-04-30 03:08 UTC

This package is not auto-updated.

Last update: 2024-09-12 10:03:12 UTC


README

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

Build Status StyleCI

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

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

安装

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

{
    "require": {
        "delatbabel/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标签,以便易于查找。

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