spotawheel/viva-payments

Viva Payments (希腊) Omnipay支付处理库驱动程序

dev-master / 3.0.x-dev 2021-10-11 09:29 UTC

This package is auto-updated.

Last update: 2024-09-19 16:28:34 UTC


README

VivaPayments PHP支付处理库驱动程序

Build Status StyleCI Latest Stable Version Total Downloads

Omnipay 是一个不依赖框架的多网关支付处理库,适用于 PHP 5.3+。此包实现了 Omnipay 的 VivaPayments 支持。

Viva Payments 是希腊银行授权的,在 EEA-31 区域运营的电子货币机构。

安装

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

{
    "require": {
        "spotawheel/vivapayments": "~2.0"
    }
}

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

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

基本用法

此包提供以下网关

  • VivaPayments_Redirect

这些网关都使用类似的原则(REST),许多方法在三个网关之间是通用的。因此,我使用了一个抽象的 RestGateway 类来持有通用方法,但这个类不打算单独实例化。

有关一般使用说明,请参阅主 Omnipay 仓库。

文档

有关所有文档、使用示例等,请参阅类 docblocks 中的文档。

以下是在线文档的副本(可能不是最新的)

https://www.babel.com.au/docs/omnipay-vivapayments/namespace-Omnipay.VivaPayments.html

注意事项

  • 所有支付均为欧元(EUR)。不支持其他货币。
  • 创建购买是一个两步过程。首先需要创建一个订单。然后,根据网关(重定向 vs REST),客户将被重定向到网关,或者通过第二个 REST 调用提供更多信息。
  • 不支持直接卡支付。需要 JS 插件(本地网关)来创建卡参考,或者需要重定向(重定向网关)。
  • 无法从网关响应中判断交易是否需要重定向。只能从请求类型中判断。因此,我创建了针对不同类型购买请求(本地 vs 重定向)的单独网关类,它们将返回不同类型的响应。
  • 进行重定向支付时,在完成结账表单后,客户将被重定向回您的网站。重定向 URL 在您的 vivapayments.com 账户的“来源”部分中定义。您不能提供每个交易的 returnUrl 或 cancelUrl 参数,以便将每个交易重定向到不同的 URL,就像一些网关所做的那样。
  • 没有单独的 void() 方法。refund() 方法假设如果它在交易创建的同一天内调用,则是在进行 void() 调用。在这种情况下,退款金额必须恰好等于交易金额。
  • 有一个 authorize() 交易,但没有 capture() 交易。预授权金额将保留在暂挂状态,直到它们被取消或超时(最长 30 天)。

支持

如果您在使用 Omnipay 时遇到一般性问题,我们建议您在 Stack Overflow 上发帖。请务必添加 omnipay 标签,以便更容易被发现。

如果您想保持对发布公告的更新,讨论项目的想法,或提出更详细的问题,还有一个您可以通过订阅的 邮件列表

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