Skip to main content
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..."
}'

{
  "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"
  }
}

​
请求参数

​
appid
string
required
用户标识
​
bankCardId
string
信用卡 ID，与 bankCardNum 二选一
​
bankCardNum
string
信用卡卡号，与 bankCardId 二选一
​
amount
string
required
转出金额
​
idempotentKey
string
required
唯一的交易id
​
timestamp
string
required
当前时间戳（毫秒）
​
sign
string
required
签名值

​
响应

​
code
integer
响应代码
​
msg
string
响应消息
​
content
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..."
}'

{
  "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"
  }
}
转出金额不能超过卡内可用余额
转出完成后，资金将退回到账户余额，可用于开卡或充值

​
使用场景

  • 余额管理：将不需要的余额转回账户
  • 关卡前：销卡前先将余额转出
  • 资金整合：将多张卡的余额整合到账户