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 的地方添加 autoloader 类的引用

   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 文件。