README

Laravel端口的天源科技SOAP工具包API。

天源科技库可在以下位置找到这里

使用composer安装

代码可在以下位置找到 Packagist。如果您想从Packagist安装SDK，请使用以下命令将依赖项添加到您的应用程序中。

composer require pinaadrian/cybersource

先决条件

Laravel 5.6或更高版本
PHP 7.1或更高版本
- 必须启用curl、openssl、soap扩展
一个天源科技账户。您可以在以下位置创建评估账户这里。
一个天源科技交易密钥。您需要在config/cybersource.php文件中的cybersource.php文件中设置您的商户ID和交易密钥。有关获取交易密钥的说明，请参阅以下内容这里。

配置

发布供应商文件

要将cybersource.php文件发布到config目录，请运行以下命令

php artisan vendor:publish --tag=cybersource

在发出任何请求之前，请确保在config/cybersource.php中配置了商户ID、交易密钥和适当的WSDL文件URL。

默认情况下，客户端的WSDL文件适用于API版本1.120。可用的WSDL文件URL可以在以下位置浏览

示例

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

创建简单请求

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

use Pinaadrian\Cybersource\CybsSoapClient;

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

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

// Populate $request here with other necessary properties

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

从XML创建请求

您可以从文件或XML字符串中创建请求。XML请求格式在以下部分的Using XML部分中描述。以下是如何从XML文件中运行交易的示例

use Pinaadrian\Cybersource\CybsSoapClient;

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

或者，您可以创建自己的XML字符串并将其替换为该字符串

use Pinaadrian\Cybersource\CybsSoapClient;

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

使用名称值对

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

use Pinaadrian\Cybersource\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);

文档

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

赵娜迪 / 天源科技

维护者

详细信息