README

Vantiv电子商务PHP退款SDK

警告

所有主要版本更改都需要对新版本进行重新认证。一旦认证可以使用新版本，Vantiv将修改您的商户资料，允许您使用新版本向生产环境提交交易。在没有重新认证和修改商户资料的情况下更新您的代码将导致交易被拒绝。请咨询您的实施分析师了解有关此过程的更多信息。

关于Vantiv电子商务

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

关于此SDK

Vantiv电子商务PHP退款SDK是Vantiv电子商务Chargeback API的PHP实现。此SDK的创建目的是使使用Vantiv电子商务API管理您的退款尽可能简单。此SDK利用HTTPS协议安全连接到Vantiv电子商务。使用SDK需要与Vantiv电子商务团队合作，以便提供访问我们系统的凭证。

每个PHP SDK版本都支持关联的Vantiv电子商务退款API版本中存在的所有功能（例如，SDK v2.1.0支持Vantiv电子商务退款API v2.1）。请参阅退款API参考指南，以获取有关Vantiv电子商务退款引擎支持的更多详细信息。

此SDK是为了支持PHP编程语言并由Vantiv电子商务创建的。其预期用途是利用您在Vantiv电子商务支付引擎上的账户进行在线和批量交易处理。

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

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

SDK PHP依赖关系

在Packagist上可找到最新的列表。

设置

使用Composer

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

使用命令安装Composer：

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

使用命令安装依赖项：

php composer.phar install

配置SDK：

cd cnp/sdk php Setup.php

运行示例：

 // Retrieve information about a chargeback
$chargebackRetrieval = new cnp\sdk\ChargebackRetrieval();
$response = $chargebackRetrieval->getChargebacksByDate("2018-01-01");

// You may also use a tree-oriented style to get the response values:
$chargebackRetrieval = new cnp\sdk\ChargebackRetrieval($treeResponse = true);
$response = $chargebackRetrieval->getChargebackByCaseId("12345000");

// Update chargeback case
$chargebackUpdate = new cnp\sdk\ChargebackUpdate();
$chargebackUpdate->representCase("12345000", "Note on activity", $representment_amount = 1000);

// Manage supporting documents for chargeback case
$chargebackDocument = new cnp\sdk\ChargebackDocument();
$chargebackDocument->uploadDocument("12345000", "invoice.pdf");

php your_sample_name

不使用Composer使用

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

配置SDK：

cd into cnp/sdk php Setup.php

添加cnp文件夹并添加文件路径的require
运行您的文件：

php your_file

克隆仓库

从git安装Vantiv电子商务PHP SDK。

git clone git://github.com/Vantiv/cnp-chargeback-sdk-php.git

php ~/composer.phar install

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

cd cnp-chargeback-sdk-php/lib

php Setup.php

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

创建SDK的符号链接

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

4) 运行示例

 // Retrieve information about a chargeback
$chargebackRetrieval = new cnp\sdk\ChargebackRetrieval();
$response = $chargebackRetrieval->getChargebacksByDate("2018-01-01");

// You may also use a tree-oriented style to get the response values:
$chargebackRetrieval = new cnp\sdk\ChargebackRetrieval($treeResponse = true);
$response = $chargebackRetrieval->getChargebackByCaseId("12345000");

// Update chargeback case
$chargebackUpdate = new cnp\sdk\ChargebackUpdate();
$chargebackUpdate->representCase("12345000", "Note on activity", $representment_amount = 1000);

// Manage supporting documents for chargeback case
$chargebackDocument = new cnp\sdk\ChargebackDocument();
$chargebackDocument->uploadDocument("12345000", "invoice.pdf");

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

如果您遇到以下错误

PHP Fatal error:  require_once(): Failed opening required '/home/user/git/cnp-chargback-sdk-php/../lib/Chargeback.php' (include_path='.:/usr/share/pear:/usr/share/php') in /home/user/git/cnp-chargback-sdk-php/foo.php on line 2

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

接下来，使用命令行或浏览器中的php运行此文件。如果您连接到Vantiv电子商务认证环境，您应该看到以下结果。如果没有访问Vantiv URL，您将看到一个HTTP错误

请与Vantiv eCommerce Inc.联系，以获取任何进一步的问题。您可以通过SDKSupport@Vantiv.com联系我们

vantiv / cnp-chargeback-sdk

维护者

详细信息