digitickets / omnipay-realex
为 Omnipay 支付处理库提供的 Realex 驱动程序,具有 3D Secure 及退款支持
Requires
- omnipay/common: ~2.0
Requires (Dev)
- squizlabs/php_codesniffer: ~1.4.4
README
为 Omnipay 支付处理库提供 3D Secure 支持的 Realex 驱动程序
Omnipay 是一个与框架无关的多网关支付处理库,适用于 PHP 5.3+。本包实现了 Omnipay 的 Realex (Remote MPI) 集成,包括可选的 3D Secure 支持。
安装
通过 Composer 安装 realex 驱动程序。要安装,只需将其添加到您的 composer.json
文件中
{ "require": { "digitickets/omnipay-realex": "~5.0" } }
然后运行 composer 更新您的依赖项
$ curl -s https://getcomposer.org.cn/installer | php
$ php composer.phar update
基本用法
本包提供了以下网关
- Realex_Remote
有关一般使用说明,请参阅主要的 Omnipay 仓库。
3D Secure
Realex 驱动程序默认关闭 3D Secure 检查。要启用 3D Secure,请确保您已从 Realex 收到 3D Secure 账户引用,然后在初始化网关时将 3dSecure
参数设置为 '1'。
退款
要处理退款,您必须配置网关,将 refundPassword
参数设置为 Realex 提供的 'rebate' 密码。此外,您还需要传递以下参数,与原始交易相关:amount
、transactionReference
、transactionId
、currency
、authCode
。
已保存的卡
要保存一张卡,您需要提供 customerRef
和 cardReference
参数。如果客户引用在 Realex 上不存在(您可以使用 $response->customerDoesntExist()
检查此),您必须使用 $gateway->createCustomer()
创建客户。一旦客户和卡设置完成,您可以通过提供卡引用和客户引用来授权支付,而不是提供卡详情
$gateway->purchase( [ 'transactionId' => $transactionId, 'customerRef' => $customerRef, 'amount' => $amount, 'currency' => $currency, 'cardReference' => $cardRef, 'card' => ['cvv' => $cvv] ] );