konalexiou / omnipay-vivapayments
Viva Payments (希腊) 用于 Omnipay 支付处理库的驱动程序
v2.0
2017-06-10 03:44 UTC
Requires
- php: >=5.3.0
- omnipay/common: ~2.0
Requires (Dev)
- apigen/apigen: ^4.1
- nette/utils: ~2.3.0
- omnipay/dummy: dev-master
- omnipay/tests: ~2.0
This package is auto-updated.
Last update: 2024-09-22 20:07:26 UTC
README
VivaPayments 驱动程序,用于 Omnipay PHP 支付处理库
Omnipay 是一个与框架无关的、多网关的 PHP 5.3+ 支付处理库。此包实现了 Omnipay 的 VivaPayments 支持。
Viva Payments 是希腊银行授权的 EEA-31 地区电子货币机构。
安装
Omnipay 通过 Composer 安装。要安装,只需
composer require konalexiou/omnipay-vivapayments
基本用法
此包提供以下网关
- VivaPayments_Redirect
- VivaPayments_Native
- VivaPayments_VivaWallet (尚未实现)
所有这些网关都使用类似的原则(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() 方法。如果退款方法是在交易创建的同一天内进行的,则假定调用 void()。在这种情况下,退款金额必须与交易金额完全相同。
- 有一个 authorize() 交易,但没有 capture() 交易。预授权金额将保留,直到取消或超时(最长 30 天)。
支持
如果您遇到 Omnipay 的一般问题,我们建议在 Stack Overflow 上发布帖子。确保添加 omnipay 标签,以便易于找到。
如果您想及时了解发布公告、讨论项目想法或提出更详细的问题,还可以订阅一个邮件列表。
如果您认为您发现了一个bug,请使用GitHub问题跟踪器进行报告,或者更好的做法是,复制库并提交一个pull request。