跳转到主要内容
POST
/
open-api
/
v1
/
account
/
transfer
curl --request POST \
  --url https://sandbox-openplatform.keysecure.io/open-api/v1/account/transfer \
  --header 'Content-Type: application/json' \
  --header 'Api-Key: your_api_key' \
  --header 'Timestamp: 1716307200000' \
  --header 'Access-Token: your_access_token' \
  --data '{
    "cardholder_no": "U202605220001",
    "transfer_unique_no": "TRANSFER_202605220001",
    "type": "In",
    "balance": "100.00"
  }'
{
  "code": 0,
  "msg": "Success",
  "data": {
    "transfer_no": "",
    "transfer_unique_no": "",
    "before_balance": "",
    "after_balance": ""
  }
}
持卡人金额划转(授信模式)。当前划转币种固定为 TUSDT

请求头

Api-Key
string
必填
apiKey(商户凭证,与 IP 白名单绑定)
Timestamp
string
必填
Unix 时间戳(毫秒),与服务端偏差须在 60 秒内,且不接受未来时间戳
Access-Token
string
必填
登录标识(除获取 Token 外必填)
Content-Type
string
默认值:"application/json"
固定为 application/json

请求体

cardholder_no
string
必填
持卡人单号
transfer_unique_no
string
必填
商户侧划转唯一单号(最长 64 字符)
type
string
必填
划转类型,见 8.9(In-转入 / Out-转出)
balance
string
必填
划转金额(支持小数点后两位)

返回参数

code
number
响应状态码,0 表示成功
msg
string
响应消息
data
object
返回数据
curl --request POST \
  --url https://sandbox-openplatform.keysecure.io/open-api/v1/account/transfer \
  --header 'Content-Type: application/json' \
  --header 'Api-Key: your_api_key' \
  --header 'Timestamp: 1716307200000' \
  --header 'Access-Token: your_access_token' \
  --data '{
    "cardholder_no": "U202605220001",
    "transfer_unique_no": "TRANSFER_202605220001",
    "type": "In",
    "balance": "100.00"
  }'
{
  "code": 0,
  "msg": "Success",
  "data": {
    "transfer_no": "",
    "transfer_unique_no": "",
    "before_balance": "",
    "after_balance": ""
  }
}