README

我们已经迁移了。我们强烈建议您使用支持所有此SDK功能并从所有未来版本中受益的Global Payments PHP SDK：https://github.com/globalpayments/php-sdk

在最新的更新（1.1.3）中，此SDK支持3D Secure 2的强制性和推荐HPP字段。从现在起，它将只接收关键安全更新，不会发布超过3D Secure 2的任何新功能更新。

Realex Payments HPP PHP SDK

您可以在https://developer.globalpay.com注册Global Payments（以前称为Realex Payments）账户。

要求

• PHP >= 5.3.9
• 出于安全和支持的目的，我们强烈建议您使用PHP 7
• Composer (https://getcomposer.org.cn/)

说明

1. 将以下内容添加到您的'composer.json'文件中

   {
       "require": {
           "realexpayments/rxp-hpp-php": "1.1.3"
       }    
   }
   

2. 在应用程序目录内运行composer

   composer update
   

   或者（根据您的服务器配置）

   php composer.phar update
   

3. 在任何需要使用SDK的地方添加自动加载类的引用

   require_once ('vendor/autoload.php');

4. 使用SDK
   

   $hppRequest = new HppRequest(); 
   $hppRequest->addMerchantId("MerchantId");
   $hppRequest->addAccount("internet");
   ....

用法

为Realex Payments JS库创建HPP请求JSON

<?php
require_once ('vendor/autoload.php');

use com\realexpayments\hpp\sdk\domain\HppRequest;
use com\realexpayments\hpp\sdk\RealexHpp;
use com\realexpayments\hpp\sdk\RealexValidationException;
use com\realexpayments\hpp\sdk\RealexException;

$hppRequest = new HppRequest(); 
$hppRequest->addMerchantId("MerchantId");
$hppRequest->addAccount("internet");
$hppRequest->addAmount("1001");
$hppRequest->addCurrency("EUR");
$hppRequest->addAutoSettleFlag(TRUE);
$hppRequest->addHppVersion("2");
// 3D Secure 2 Mandatory and Recommended Fields
$hppRequest->addCustomerEmailAddress("james.mason@example.com");
$hppRequest->addCustomerMobilePhoneNumber("44|07123456789");
$hppRequest->addBillingAddressLine1("Flat 123");
$hppRequest->addBillingAddressLine2("House 456");
$hppRequest->addBillingAddressLine3("Unit 4");
$hppRequest->addBillingCity("Halifax");
$hppRequest->addBillingPostalCode("W5 9HR");
$hppRequest->addBillingCountryCode("826");
$hppRequest->addShippingAddressLine1("Apartment 825");
$hppRequest->addShippingAddressLine2("Complex 741");
$hppRequest->addShippingAddressLine3("House 963");
$hppRequest->addShippingCity("Chicago");
$hppRequest->addShippingState("IL");
$hppRequest->addShippingPostalCode("50001");
$hppRequest->addShippingCountryCode("840");

$realexHpp = new RealexHpp("Shared Secret");

try {
    $requestJson = $realexHpp->requestToJson($hppRequest, false);
    // TODO: pass the HPP request JSON to the JavaScript, iOS or Android Library
}
catch (RealexValidationException $e) {
    // TODO: Add your error handling here
}
catch (RealexException $e) {
    // TODO: Add your error handling here
}

从Realex Payments JS库消耗响应JSON

<?php
require_once ('vendor/autoload.php');

use com\realexpayments\hpp\sdk\domain\HppResponse;
use com\realexpayments\hpp\sdk\RealexHpp;

$realexHpp = new RealexHpp("mySecret");
$hppResponse = $realexHpp->responseFromJson(responseJson);

许可

查看LICENSE文件。