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

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

​
请求参数

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

​
响应

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

{
  "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 + (100 × 3%) = $103