curl --location --request POST 'https://kf.pikabao.cc/agent/v1/cards/recharge' \
--header 'Content-Type: application/json' \
--data-raw '{
"appid": "user123",
"bankCardId": "111222333",
"amount": "50.00",
"timestamp": "1640995200000",
"sign": "ABC123..."
}'
const data = {
appid: "user123",
bankCardId: "111222333",
amount: "50.00",
timestamp: Date.now().toString(),
};
const sign = generateSign(data, secretKey);
data.sign = sign;
const response = await fetch("https://kf.pikabao.cc/agent/v1/cards/recharge", {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify(data),
});
const result = await response.json();
{
"code": 0,
"msg": "",
"content": {
"id": "111222333",
"userBankCardId": "4654654",
"state": 1,
"createTime": "2023-01-01 00:00:00",
"modifyTime": "2023-01-01 00:00:00",
"bankCard": {
"id": "111222333",
"organization": "VISA",
"state": 1,
"number": "5572710152044****",
"expiryDate": "10/25",
"cvv": "456",
"remark": "我的虚拟卡",
"createTime": "2023-01-01 00:00:00",
"modifyTime": "2023-01-01 00:00:00",
"cardBalance": "150.00"
}
}
}
充值与转出
信用卡充值
为已开通的虚拟信用卡充值
POST
/
agent
/
v1
/
cards
/
recharge
curl --location --request POST 'https://kf.pikabao.cc/agent/v1/cards/recharge' \
--header 'Content-Type: application/json' \
--data-raw '{
"appid": "user123",
"bankCardId": "111222333",
"amount": "50.00",
"timestamp": "1640995200000",
"sign": "ABC123..."
}'
const data = {
appid: "user123",
bankCardId: "111222333",
amount: "50.00",
timestamp: Date.now().toString(),
};
const sign = generateSign(data, secretKey);
data.sign = sign;
const response = await fetch("https://kf.pikabao.cc/agent/v1/cards/recharge", {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify(data),
});
const result = await response.json();
{
"code": 0,
"msg": "",
"content": {
"id": "111222333",
"userBankCardId": "4654654",
"state": 1,
"createTime": "2023-01-01 00:00:00",
"modifyTime": "2023-01-01 00:00:00",
"bankCard": {
"id": "111222333",
"organization": "VISA",
"state": 1,
"number": "5572710152044****",
"expiryDate": "10/25",
"cvv": "456",
"remark": "我的虚拟卡",
"createTime": "2023-01-01 00:00:00",
"modifyTime": "2023-01-01 00:00:00",
"cardBalance": "150.00"
}
}
}
请求参数
string
required
用户标识
string
信用卡 ID,与 bankCardNum 二选一
string
required
唯一的交易id
string
信用卡卡号,与 bankCardId 二选一
string
required
充值金额
string
required
当前时间戳(毫秒)
string
required
签名值
响应
integer
响应代码
string
响应消息
object
curl --location --request POST 'https://kf.pikabao.cc/agent/v1/cards/recharge' \
--header 'Content-Type: application/json' \
--data-raw '{
"appid": "user123",
"bankCardId": "111222333",
"amount": "50.00",
"timestamp": "1640995200000",
"sign": "ABC123..."
}'
const data = {
appid: "user123",
bankCardId: "111222333",
amount: "50.00",
timestamp: Date.now().toString(),
};
const sign = generateSign(data, secretKey);
data.sign = sign;
const response = await fetch("https://kf.pikabao.cc/agent/v1/cards/recharge", {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify(data),
});
const result = await response.json();
{
"code": 0,
"msg": "",
"content": {
"id": "111222333",
"userBankCardId": "4654654",
"state": 1,
"createTime": "2023-01-01 00:00:00",
"modifyTime": "2023-01-01 00:00:00",
"bankCard": {
"id": "111222333",
"organization": "VISA",
"state": 1,
"number": "5572710152044****",
"expiryDate": "10/25",
"cvv": "456",
"remark": "我的虚拟卡",
"createTime": "2023-01-01 00:00:00",
"modifyTime": "2023-01-01 00:00:00",
"cardBalance": "150.00"
}
}
}
注意事项
充值会收取手续费,费率根据所选 BIN 而定,请参考获取可用BIN接口
充值完成后,可通过充值详情接口查询充值结果
费用计算
充值实际扣费 = 充值金额 + (充值金额 × 充值费率) 示例:- 充值金额:$100
- 充值费率:3%
- 实际扣费:100+(100 × 3%) = $103
⌘I
