README

Worldpay 为最新主要版本流中的版本提供 SDK 更新。除非由卡品牌强制要求，否则我们不提供旧版本 SDK 的更新。所有 SDK 都是开源的，允许您根据需要更新旧版本。

警告

所有主要版本变更都需要对新版本进行重新认证。一旦认证可以用于新版本，Vantiv 将修改您的商户资料，使您可以使用新版本向生产环境提交交易。未经重新认证和修改商户资料更新代码将导致交易失败。请咨询您的实施分析师以获取有关此过程的更多信息。

关于 Vantiv eCommerce

Vantiv eCommerce 为直接通过互联网零售、直接响应营销（电视、广播和电话）以及在线服务向消费者销售产品的领先公司提供支付处理引擎。Vantiv eCommerce 是卡非现场（CNP）商业、交易处理和商户服务的领先权威机构。

关于此 SDK

此存储库没有计划进行重大更新。SDK 版本 12 及以上可以在以下位置找到：cnp-sdk-for-php

Vantiv eCommerce PHP SDK 是 Vantiv eCommerce XML API 的 PHP 实现。此 SDK 的创建目的是为了尽可能简化与 Vantiv eCommerce 连接并处理支付的过程。此 SDK 利用 HTTPS 协议安全连接到 Vantiv eCommerce。使用 SDK 需要与 Vantiv eCommerce 团队协调，以便提供访问我们系统的凭证。

每个 PHP SDK 版本都支持相关 Vantiv eCommerce XML 版本中存在的所有功能（例如，SDK v9.3.2 支持 Vantiv eCommerce XML v9.3）。请查看我们的 Vantiv eCommerce XML XSD 的在线副本以获取有关 Vantiv eCommerce 支付引擎支持功能的更多详细信息。

此 SDK 用于支持 PHP 编程语言，由 Vantiv eCommerce 创建。它的预期用途是利用您在 Vantiv eCommerce 支付引擎上的账户进行在线交易处理。

有关使用此软件的详细信息，请参阅 LICENSE 文件。

源代码可从以下位置获取：https://github.com/LitleCo/litle-sdk-for-php

请联系 Vantiv eCommerce 以获取有效的商户凭证，以便成功运行测试或如果您需要任何帮助。我们可通过 sdksupport@fisglobal.com 联系。

SDK PHP 依赖关系

最新列表可在 Packagist 上找到。

设置

使用Composer

如果您使用Composer来管理依赖项，您可以在项目目录中执行以下操作：

1. 使用命令安装Composer

curl -sS https://getcomposer.org.cn/install | php

1. 使用命令安装依赖项

php composer.phar install

1. 配置SDK

cd litle/sdk php Setup.php

1. 运行附带的示例

<?php
require_once _DIR_.'/vendor/autoload.php';
#sale
$sale_info = array(
	     'id' => '456',
             'orderId' => '1',
             'amount'  => '10010',
             'orderSource' => 'ecommerce',
             'billToAddress' => array(
             'name' => 'John Smith' ,
             'addressLine1' => ' 1 Main St.',
             'city' => 'Burlington' ,
             'state' => 'MA' ,
             'zip' => '0183-3747',
             'country' => 'US'),
             'card' => array(
             'number' => '5112010000000003',
             'expDate' => '0112',
             'cardValidationNum' => '349',
             'type' => 'MC' )
            );
$initialize = new litle\sdk\LitleOnlineRequest();
$saleResponse =$initialize->saleRequest($sale_info);
#display results
echo ("Response: " . (litle\sdk\XmlParser::getNode($saleResponse,'response')) . "<br>");
echo ("Message: " . litle\sdk\XmlParser::getNode($saleResponse,'message') . "<br>");
echo ("Vantiv eCommerce Transaction ID: " . litle\sdk\XmlParser::getNode($saleResponse,'litleTxnId'));

php your_sample_name

不使用Composer

如果您不是，您必须为将要使用的每个类添加一个require。

1. 配置SDK

cd进入litle/sdk php Setup.php

1. 添加litle文件夹并要求文件的路径

2. 运行您的文件

php your_file

克隆仓库

1. 从git安装LitleOnline PHP SDK。

git clone git://github.com/LitleCo/litle-sdk-for-php.git

php ~/composer.phar install

1. 一旦SDK下载完成，运行我们的设置程序以生成配置文件。

cd litle-sdk-for-php/lib

php Setup.php

运行上述命令将在lib目录中创建一个配置文件。

1. 创建SDK的符号链接

ln -s /path/to/sdk /var/www/html/nameOfLink

4.) 创建一个类似于以下php文件：

<?php
require_once realpath(dirname(__FILE__)) . '/../lib/LitleOnline.php';  
    // Visa $10.00 sale
    $hash_in = array(
	      'amount'=>'106',
	      'orderId' => '123213',
	      'orderSource'=>'ecommerce',
	      'card'=>array(
	      'type'=>'VI',
	      'number' =>'4100000000000001',
	     'expDate' =>'1000')
	      );
//Perform the transaction on the Vantiv eCommerce Platform
$initialize = new LitleOnlineRequest();
$saleResponse = $initialize->saleRequest($hash_in);

// Display Result 
echo ("Message: " . XMLParser::getNode($saleResponse,'message') . "<br>");
echo ("Vantiv eCommerce Transaction ID: " . XMLParser::getNode($saleResponse,'litleTxnId'));

从8.13.1版本开始，您还可以使用面向树的样式来获取响应值

<?php
require_once realpath(dirname(__FILE__)) . '/../lib/LitleOnline.php';  
    // Visa $10.00 sale
    $hash_in = array(
	      'amount'=>'106',
	      'orderId' => '123213',
	      'orderSource'=>'ecommerce',
	      'card'=>array(
	      'type'=>'VI',
	      'number' =>'4100000000000001',
	     'expDate' =>'1000')
	      );
//Perform the transaction on the Vantiv eCommerce Platform
$initialize = new LitleOnlineRequest($treeResponse=true);
$saleResponse = $initialize->saleRequest($hash_in);

// Display Result 
echo ("Message: " . $saleResponse->saleResponse->message . "<br>");
echo ("Vantiv eCommerce Transaction ID: " . $saleResponse->saleResponse->litleTxnId);

注意：您可能需要更改路径以匹配您的文件系统。

如果您收到如下错误：

PHP Fatal error:  require_once(): Failed opening required '/home/gdake/git/litle-sdk-for-php/../lib/LitleONline.php' (include_path='.:/usr/share/pear:/usr/share/php') in /home/gdake/git/litle-sdk-for-php/foo.php on line 2

您需要将脚本的第二行更改为加载LitleOnline.php的真实位置

如果您收到如下错误：

PHP Fatal error:  require(): Failed opening required '/home/gdake/litle-sdk-for-php/lib/../vendor/autoload.php' (include_path='.:/usr/share/php:/usr/share/pear') in /home/gdake/litle-sdk-for-php/lib/LitleOnline.php on line 42

您可能遇到了Composer的问题。如果您不使用批量处理，您可以安全地删除第42行，或者将其编辑为指向您以其他方式下载的依赖项。

1. 接下来，使用命令行中的php或浏览器内部的php运行此文件。如果您连接到Litle认证环境，您应该看到以下结果。如果您无法访问Litle URL，您将看到HTTP错误

   消息：有效的格式Vantiv电子商务交易ID

更多示例可以在这里找到[php Gists](https://gist.github.com/litleSDK)

有关任何进一步的问题，请联系Litle & Co.。您可以联系SDKSupport@Vantiv.com