Adyen 定期支付 API 管理指南

接入教程

1. 在支付请求中创建并验证支付令牌
2. 使用 API 接口管理已保存的支付信息
3. 通过定期支付 API 设置和管理定期支付
4. 需要时安全删除令牌或支付信息
5. 参考 Tokenization 文档了解更多详情

使用 Python 列出存储的支付方式

python

import requests

url = "https://api.adyen.com/recurring/v68/listRecurringDetails"
headers = {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "merchantAccount": "YOUR_MERCHANT_ACCOUNT",
    "shopperReference": "UNIQUE_SHOPPER_ID"
}

response = requests.post(url, json=payload, headers=headers)
print(response.status_code)
print(response.json())

使用 PHP 禁用支付令牌

php

<?php

$url = 'https://api.adyen.com/recurring/v68/disable';
$apiKey = 'YOUR_API_KEY';
$data = [
    'merchantAccount' => 'YOUR_MERCHANT_ACCOUNT',
    'recurringDetailReference' => 'TOKEN_TO_DISABLE'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Key: ' . $apiKey,
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo "Status: $httpCode\n";
echo "Response: $response\n";
?>

使用 JavaScript 创建支付令牌

javascript

const fetch = require('node-fetch'); // For Node.js

const url = 'https://api.adyen.com/recurring/v68/createToken';
const apiKey = 'YOUR_API_KEY';
const payload = {
  merchantAccount: 'YOUR_MERCHANT_ACCOUNT',
  shopperReference: 'UNIQUE_SHOPPER_ID',
  card: {
    number: '4111111111111111',
    expiryMonth: '03',
    expiryYear: '2030',
    cvc: '737'
  }
};

fetch(url, {
  method: 'POST',
  headers: {
    'X-API-Key': apiKey,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(payload)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

常见问题

支付令牌是如何创建的？

支付令牌应在支付请求过程中，通过客户授权并验证支付方式后创建。您不应直接调用API创建未经验证的令牌。请参考Adyen的令牌化文档了解最佳实践。

如何安全地存储API密钥？

API密钥是敏感凭证，必须安全存储。切勿将其嵌入客户端代码或公开存储库。推荐使用环境变量或安全的密钥管理服务，并确保API密钥仅具有所需的最小权限。

调用API时常见的认证错误有哪些？

常见的认证错误包括：API密钥无效或已过期、请求头中缺少'X-API-Key'字段、API密钥权限不足无法访问特定端点，或使用了错误的API环境（如测试密钥用于生产环境）。请检查密钥的有效性和请求头设置。