# 5、新增代付订单

请求方式

  • POST

请求 URL

/api/v3/wallet/transfer

请求 Header

Content-Type: application/json;charset=utf-8

请求头参数

参数名 类型 描述 示例值
access_key String 商户后台获取 pFqV75X3
timestamp int64 13位时间戳(毫秒) 1679724896223
nonce String 随机字符串(UUID V4) 794c26b0-d33c-4394-b2bb-c485eca16d9e
sign String 使用密钥生成的签名 kAXyh+eerqrefyaF8dyFB0M4FVo=

请求参数(JSON)

{
  "externalOrderId": "622257420681202921",
  "addressTo": "0xa8666442fA7583F783a169CC9F5449ec660295E8",
  "chainType": "ETH",
  "tokenType": "USDT",
  "currencyType": "USD",
  "cryptoAmount": "1",
  "notifyUrl": "http://192.168.1.135:30002/url",
  "remark": "http://192.168.1.135:30002/url"
}

参数说明

参数名 类型 描述 是否必填
externalOrderId String 商户订单ID(最大64位) ✅ 是
addressTo String 接收钱包地址(最大64位) ✅ 是
chainType String 主链类型:TRON BSC ETH SOLANA ✅ 是
tokenType String 加密币种,枚举值:USDT USDC PEPE ✅ 是
cryptoAmount String 加密金额,根据代币精度(与currencyAmount二选一) ⛔ 可选
currencyType String 法币类型(USD、BRL等) ⛔ 可选
currencyAmount String 法币金额,小数点后不超过2位(与cryptoAmount二选一;根据实时汇率计算 cryptoAmount) ⛔ 可选
notifyUrl String 回调地址 ⛔ 可选
remark String 备注信息,最大长度1024字符 ⛔ 可选

响应类型

Header: {
  "Content-Type": "application/json;charset=utf-8"
}

响应示例

{
  "code": "200",
  "success": true,
  "msg": "成功",
  "msgEn": "SUCCESS",
  "data": {
    "orderId": "OCRYPDRAW202307310902401690794160841DOCKER020000000200001109",
    "orderStatus": "Accepted",
    "addressTo": "0xa8666442fA7583324324169CC9F5449ec660295E8",
    "chainType": "ETH",
    "tokenType": "USDT",
    "tokenAmount": 1,
    "externalOrderId": "622257420681202921"
  }
}

响应参数说明

参数名 类型 描述
orderId String 平台订单ID
orderStatus String 订单状态(Accepted 等)
addressTo String 收款地址
chainType String 区块链类型
tokenType String 加密币种类型
tokenAmount float64 加密币种金额
externalOrderId String 商户订单ID