curl --location --request POST 'https://kf.pikabao.cc/agent/v1/cards/cashout' \
--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/cashout", {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify(data),
});
const result = await response.json();
{
"code": 0,
"msg": "",
"content": {
"id": "111222333",
"userBankCardId": "444555666",
"userBankCardNum": "5572710152044****",
"state": 1,
"amount": "50.00",
"createTime": "2023-01-01 00:00:00",
"modifyTime": "2023-01-01 00:00:00"
}
}
充值与转出
信用卡资金转出
将虚拟信用卡内的余额转出到账户余额
POST
/
agent
/
v1
/
cards
/
cashout
curl --location --request POST 'https://kf.pikabao.cc/agent/v1/cards/cashout' \
--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/cashout", {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify(data),
});
const result = await response.json();
{
"code": 0,
"msg": "",
"content": {
"id": "111222333",
"userBankCardId": "444555666",
"userBankCardNum": "5572710152044****",
"state": 1,
"amount": "50.00",
"createTime": "2023-01-01 00:00:00",
"modifyTime": "2023-01-01 00:00:00"
}
}
请求参数
string
required
用户标识
string
信用卡 ID,与 bankCardNum 二选一
string
信用卡卡号,与 bankCardId 二选一
string
required
转出金额
string
required
唯一的交易id
string
required
当前时间戳(毫秒)
string
required
签名值
响应
integer
响应代码
string
响应消息
object
curl --location --request POST 'https://kf.pikabao.cc/agent/v1/cards/cashout' \
--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/cashout", {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify(data),
});
const result = await response.json();
{
"code": 0,
"msg": "",
"content": {
"id": "111222333",
"userBankCardId": "444555666",
"userBankCardNum": "5572710152044****",
"state": 1,
"amount": "50.00",
"createTime": "2023-01-01 00:00:00",
"modifyTime": "2023-01-01 00:00:00"
}
}
转出金额不能超过卡内可用余额
转出完成后,资金将退回到账户余额,可用于开卡或充值
使用场景
- 余额管理:将不需要的余额转回账户
- 关卡前:销卡前先将余额转出
- 资金整合:将多张卡的余额整合到账户
⌘I
