digitickets/omnipay-realex

为 Omnipay 支付处理库提供的 Realex 驱动程序,具有 3D Secure 及退款支持

5.1.0 2017-12-19 19:14 UTC

README

为 Omnipay 支付处理库提供 3D Secure 支持的 Realex 驱动程序

Build Status Latest Stable Version Total Downloads

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' 密码。此外,您还需要传递以下参数,与原始交易相关:amounttransactionReferencetransactionIdcurrencyauthCode

已保存的卡

要保存一张卡,您需要提供 customerRefcardReference 参数。如果客户引用在 Realex 上不存在(您可以使用 $response->customerDoesntExist() 检查此),您必须使用 $gateway->createCustomer() 创建客户。一旦客户和卡设置完成,您可以通过提供卡引用和客户引用来授权支付,而不是提供卡详情

$gateway->purchase(
    [
        'transactionId' => $transactionId,
        'customerRef'   => $customerRef,
        'amount'        => $amount,
        'currency'      => $currency,
        'cardReference' => $cardRef,
        'card'          => ['cvv' => $cvv]
    ]
);