# 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 ✅ 是
tokenType String 加密幣種,枚舉值:USDT USDC ✅ 是
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