README

这是官方支持的用于使用 Adyen API 的 PHP 库。

集成

该库支持以下服务下的所有 API

Checkout API：我们接受在线支付的最新集成。当前支持的版本：v68
Payments API：我们经典的在线支付集成。当前支持的版本：v51
Recurring API：管理已保存支付详情的端点。当前支持的版本：v49
Payouts API：向您的客户发送资金的端点。当前支持的版本：v51
Platforms APIs：使用 Adyen for Platforms 时的一组 API。
- Account API 当前支持的版本：v5
- Fund API 当前支持的版本：v5
- Notification Configuration API 当前支持的版本：v5
基于云的终端 API：我们的销售点集成。
Referrals API：为 Adyen 风险规则自动提交引用的端点。
HOP API：Adyen for Platforms 主机注册 API。当前支持的版本：v5

有关更多信息，请参阅我们的文档或 API 探索器。

先决条件

Adyen 测试账户
API 密钥。对于测试，您的 API 凭证需要具有 API PCI Payments 角色。
PHP 7.3 或更高版本
支持 SSL 的 cURL。
JSON PHP 扩展。
请参阅 Composer 需求列表以获取依赖项的完整列表。

支持旧版本

如果使用 PHP 7.2 或更低版本，请下载我们的库版本 6.3.0。

安装

您可以使用 Composer。如果您尚未安装 composer，请按照安装说明进行操作。

composer require adyen/php-api-library

在您的 PHP 脚本中，请确保包含自动加载器

require __DIR__ . '/vendor/autoload.php';

或者，您可以下载 GitHub 上的发布版本。

使用库

使用 API 密钥的一般用法

将客户端设置为单例资源；您将使用它进行对 Adyen 的 API 调用

$client = new \Adyen\Client();

$client->setXApiKey("YOUR API KEY");
$client->setEnvironment(\Adyen\Environment::TEST);
$client->setTimeout(30);

$service = new \Adyen\Service\Checkout($client);

$json = '{
      "card": {
        "encryptedCardNumber" => "test_4111111111111111",
        "encryptedExpiryMonth" => "test_03",
        "encryptedExpiryYear" => "test_2030",
        "encryptedSecurityCode" => "test_737"
        "holderName": "John Smith"
      },
      "amount": {
        "value": 1500,
        "currency": "EUR"
      },
      "reference": "payment-test",
      "merchantAccount": "YOUR MERCHANT ACCOUNT"
}';

$params = json_decode($json, true);

$result = $service->payments($params);

使用 API 密钥进行实时环境的一般用法

$client = new \Adyen\Client();
$client->setXApiKey("YOUR API KEY");
$client->setEnvironment(\Adyen\Environment::LIVE, 'Your live URL prefix');
$client->setTimeout(30);
 
...

基本认证下的通用使用

$client = new \Adyen\Client();
$client->setUsername("YOUR USERNAME");
$client->setPassword("YOUR PASSWORD");
$client->setEnvironment(\Adyen\Environment::TEST);
$client->setTimeout(30);

$service = new \Adyen\Service\Payment($client);

$json = '{
      "card": {
        "number": "4111111111111111",
        "expiryMonth": "10",
        "expiryYear": "2020",
        "cvc": "737",
        "holderName": "John Smith"
      },
      "amount": {
        "value": 1500,
        "currency": "EUR"
      },
      "reference": "payment-test",
      "merchantAccount": "YOUR MERCHANT ACCOUNT"
}';

$params = json_decode($json, true);

$result = $service->authorise($params);

示例集成

要更详细地了解我们的PHP库如何工作，请克隆我们的Laravel示例集成。这包括注释代码、突出显示关键特性和概念，以及使用库可以执行的API调用示例。

运行测试

对于所需的测试用例，您需要在您的账户上启用PCI权限。由于信用卡数据通过我们的javascript库进行加密，因此没有针对CSE的测试用例。默认情况下，测试将被跳过。如果您有这些权限，请在config/test.ini文件中填写您的账户详细信息，以便测试工作。要使自动测试用例适用于您的账户，请更改config/test.ini文件中的凭据。

贡献

我们鼓励您为此存储库做出贡献，这样每个人都可以从新功能、错误修复以及任何其他改进中受益。查看我们的贡献指南，了解如何提出pull request。

支持

如果您有功能请求，或发现了错误或技术问题，请在此处创建一个问题。

对于其他问题，请联系我们的支持团队。

许可

此存储库可在MIT许可下使用。

merry-goblin / php-api-library

维护者

详细信息