# 2、創建代付
請求方式
- 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": "0x13666442fA7583F12369CC9F5449ec660295E8",
"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(64) | 商戶訂單 ID | 是 |
| addressTo | String(64) | 收款地址(用戶錢包地址) | 是 |
| chainType | String | 主鏈類型:TRON BSC ETH | 是 |
| tokenType | String | 加密幣種,枚舉值:USDT USDC | 是 |
| cryptoAmount | String | 加密金額,精度根據代幣取(與cashierCurrencyAmount二選一) | 否 |
| currencyType | String | 法幣類型,枚舉值:USD、BRL、CNY(若傳入 currencyAmount 必傳) | 否 |
| 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": "0xa8666442fA7583F783a169CC9F5449ec660295E8",
"chainType": "ETH",
"tokenType": "USDT",
"tokenAmount": 1,
"externalOrderId": "622257420681202921"
}
}
響應參數說明
| 參數名 | 類型 | 描述 |
|---|---|---|
| orderId | String | 平台訂單 ID |
| orderStatus | String | 訂單狀態(如:Accepted) |
| addressTo | String | 目標地址 |
| chainType | String | 主鏈類型 |
| tokenType | String | 加密代幣類型 |
| tokenAmount | Float64 | 實際支付代幣金額 |
| externalOrderId | String | 商戶訂單號 |