# 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 |