README

#CyberSource PHP客户端

这是CyberSource SOAP Toolkit API的PHP客户端。

[] (https://travis-ci.org/CyberSource/cybersource-sdk-php)

##Packagist cyber/source-sdk-php在Packagist上可用。如果您想从Packagist安装SDK，请在应用程序的'composer.json'中添加以下依赖项。

"require": {
"cybersource/sdk-php": "*"
 },

##先决条件

PHP 5.3或更高版本
- curl、openssl、soap扩展必须启用
CyberSource账户。您可以在此处创建评估账户。
CyberSource交易密钥。您需要在lib/conf目录下的cybs.ini文件中设置您的商户ID和交易密钥。获取交易密钥的说明在此处。

##安装

您可以通过Composer或手动方式安装客户端。在安装之前，请确保在cybs.ini中配置了商户ID、交易密钥以及适当的WSDL文件URL。默认情况下，客户端的WSDL文件适用于API版本1.120（当此包更新时的最新版本）。可用的WSDL文件URL可以在以下位置浏览：

###使用Composer安装首先，您需要确保已安装Composer。您可以按照官方网站上的说明操作。Composer安装完成后，进入项目根目录并运行

composer.phar install

然后，为了使用客户端，您需要包含Composer生成的autoload文件

require_once('/path/to/project/vendor/autoload.php');

###手动安装要手动使用客户端，请将CyberSource客户端包含在您的项目中

require_once('/path/to/project/lib/CybsSoapClient.php');

##入门 PHP客户端会为您生成请求消息头，并包含由WSDL文件指定的方法。

###创建简单请求您将使用的主要方法是runTransaction()。要运行交易，您首先需要构建一个客户端以生成请求对象，您可以填充必要的字段（有关示例请求的文档，请参阅此处）。对象将被转换为XML，因此对象的属性需要与正确的XML格式相对应。

$client = new CybsSoapClient();
$request = $client->createRequest();

$card = new stdClass();
$card->accountNumber = '4111111111111111';
$card->expirationMonth = '12';
$card->expirationYear = '2020';
$request->card = $card;

// Populate $request here with other necessary properties

$reply = $client->runTransaction($request);

### 从XML创建请求您可以从文件或XML字符串创建请求。XML请求格式在《使用XML》部分中描述，请参阅此处。以下是使用XML文件运行交易的步骤

$referenceCode = 'your_merchant_reference_code';
$client = new CybsSoapClient();
$reply = $client->runTransactionFromFile('path/to/my.xml', $referenceCode);

或者，您也可以创建自己的XML字符串并使用它

$xml = "";
// Populate $xml
$client = new CybsSoapClient();
$client->runTransactionFromXml($xml);

### 使用名称-值对为了使用名称-值对运行交易，请确保在cybs.ini中设置了NVP交易处理器的WSDL值。然后使用CybsNameValuePairClient如下

$client = new CybsNameValuePairClient();
$request = array();
$request['ccAuthService_run'] = 'true';
$request['merchantID'] = 'my_merchant_id';
$request['merchantReferenceCode'] = $'my_reference_code';
// Populate $request
$reply = $client->runTransaction($request);

## 运行示例在配置您的商户ID和交易密钥后，在cybs.ini中，可以从项目根目录运行samples目录中的示例。例如

php samples/Sale.php

如果成功，示例将输出每个请求的响应对象。请注意，示例包含测试数据，不应在生产环境中运行。

## 测试

要运行测试，您需要PHPUnit。您还需要使用Composer进行自动加载。如果您使用Composer安装了客户端，则此设置已设置。否则，仅从项目根目录运行Composer进行自动加载

composer.phar dump-autoload

如果您使用Composer安装了PHPUnit，请从项目根目录使用命令vendor/bin/phpunit运行测试。

## 文档

有关CyberSource服务的更多信息，请参阅http://www.cybersource.com/developers/documentation

有关所有其他支持需求，请参阅http://www.cybersource.com/support

redhotmagma-es / cybersource-sdk-php

维护者

详细信息

README