Adyen储值API

接入教程

1. 注册Adyen商户账号并获取API密钥
2. 接入储值API端点，配置商户信息
3. 调用余额查询接口验证连接
4. 实现充值、消费等核心交易功能
5. 部署到生产环境并监控API调用状态

查询储值卡余额

python

import requests

url = "https://api.example.com/v1/balance"
headers = {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "cardNumber": "CARD_NUMBER_PLACEHOLDER",
    "merchantAccount": "MERCHANT_ACCOUNT_PLACEHOLDER"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

为储值卡充值

php

<?php
$url = "https://api.example.com/v1/topup";
$headers = [
    "X-API-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
$data = [
    "cardNumber" => "CARD_NUMBER_PLACEHOLDER",
    "amount" => [
        "value" => 1000,
        "currency" => "USD"
    ],
    "merchantAccount" => "MERCHANT_ACCOUNT_PLACEHOLDER"
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
$response = curl_exec($ch);
curl_close($ch);
echo $response;

获取储值卡交易记录

javascript

const fetch = require('node-fetch');

const url = "https://api.example.com/v1/transactions";
const headers = {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
};
const body = JSON.stringify({
    cardNumber: "CARD_NUMBER_PLACEHOLDER",
    merchantAccount: "MERCHANT_ACCOUNT_PLACEHOLDER",
    startDate: "2024-01-01",
    endDate: "2024-12-31"
});

fetch(url, {
    method: 'POST',
    headers: headers,
    body: body
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

常见问题

Adyen储值API支持哪些常见的储值业务场景？

该API主要支持预付卡、礼品卡、会员积分、电子钱包等储值业务场景，提供余额查询、充值、消费扣款、交易记录查询、卡片状态管理等功能，适用于零售、电商、餐饮、娱乐等多个行业。

使用API时，如何确保交易的安全性和合规性？

应通过HTTPS协议调用API，使用由Adyen颁发的API密钥进行认证。所有涉及金额的操作需遵循PCI DSS标准，建议在服务器端处理敏感请求，避免在前端暴露API密钥。同时，需遵守相关地区的金融监管规定。

调用API时遇到'Invalid Merchant Account'错误应如何排查？

首先确认请求头或参数中的'merchantAccount'值是否正确，需使用Adyen商户后台提供的有效商户账号。其次检查该账号是否已启用储值服务权限，以及API密钥是否与该商户账号绑定。如问题持续，请联系Adyen技术支持。