README

Omnipay PHP 支付处理库的全应用网关网关

Omnipay 是一个不依赖框架、多网关的 PHP 7.2+ 支付处理库。此包实现了 Omnipay 对全应用网关的支持。

安装

通过 Composer

$ composer require league/omnipay:^3 knightar/omnipay-total-apps-gateway

使用方法

此包提供了以下网关

• 全应用网关

####此驱动程序支持 Omnipay v3。要使用过时的 v2 包，请参阅 v.0.1.0 版本。

有关一般使用说明，请参阅主 Omnipay 存储库。

此驱动程序支持以下交易类型

• authorize($options) - 在客户的卡上授权金额
• capture($options) - 捕获之前已授权的金额
• purchase($options) - 授权并在客户的卡上立即捕获金额
• refund($options) - 退款已处理的交易
• void($options) - 通常只能在提交交易后 24 小时内调用

网关实例化

    $gateway = Omnipay::create('TotalAppsGateway');
    $gateway->setApiKey('6457Thfj624V5r7WUwc5v6a68Zsd6YEm');

purchase 示例

    $formData = array('number' => '4111111111111111', 'expiryMonth' => '10', 'expiryYear' => '2025', 'cvv' => '123');
    $gateway->purchase([
        'amount' => '10.00',
        'card'   => $formData
    ]);

驱动程序还支持使用 cardReference 替代 card 通过客户的保险库中的商店卡进行支付，使用 cardReference 参数与保险库函数一起使用。

此驱动程序还支持将客户数据存储在 Total Apps Gateway 的客户保险库中

• createCard($options) - 在客户保险库中创建条目
• updateCard($options) - 更新客户保险库中的条目
• deleteCard($options) - 删除客户保险库中的条目

    $formData = array('number' => '4111111111111111', 'expiryMonth' => '10', 'expiryYear' => '2025', 'cvv' => '123');
    
    $response = $gateway->createCard([
        'card'          => $formData
    ])->send();
    
    $cardReference = $response->getCardReference();

可以使用 cardReference 对授权、购买和退款请求进行操作

    $gateway->purchase([
        'amount'        => '10.00',
        'cardReference' => '1234567890'
    ]);

此驱动程序还支持使用 \Omnipay\TotalAppsGateway\ACH 类进行 ACH 相关交易的验证，以及 Gateway 中的 createACH、updateACH 方法。您的商户账户必须经过批准并激活此功能。

待办事项列表中的 API 调用将最终实现

• 添加、更新、删除、列出定期计划
• 按客户列出订阅
• 在开始销售/授权/信用/验证交易时将客户添加到保险库

我们目前没有计划实现以下调用（接受拉取请求以添加它们）

• 添加自定义订阅 - 不返回取消所需的订阅 ID
• 添加客户和订阅 - 不返回取消所需的订阅 ID

注意：已实现信用 API 调用，但默认情况下未在商户账户上启用，如需此功能，请联系 Total Apps Gateway。请注意，此代码未经过测试。

支持

如果您在使用 Omnipay 时遇到一般问题，我们建议在 Stack Overflow 上发表帖子。请确保添加 omnipay 标签，以便容易找到。

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

如果您认为您已经发现了一个错误，请使用 GitHub 问题跟踪器 报告它，或者更好的是，分叉库并提交拉取请求。

更改日志

请参阅变更日志获取有关最近更改的更多信息。

测试

$ composer test

贡献

请参阅贡献指南以获取详细信息。

安全

如果您发现任何安全相关的问题，请通过jablonski.kce@gmail.com发送电子邮件，而不是使用问题跟踪器。

致谢

• Brandon Lis
• 所有贡献者

许可

MIT 许可证（MIT）。请参阅许可文件以获取更多信息。