USDT(OMNI)支付接口文檔

當前加密數字貨幣USDT的市值已超九十億美圓，僅次於「數字黃金」BTC和V神的ETH，而且超越「黑馬」瑞波幣，成爲加密數字貨幣市值「三弟」。

 

穩定幣USDT應用場景

 

1. 跨境支付和套利

穩定幣USDT已被普遍用於跨境支付場景，特別是數字貨幣交易所之間的跨境支付，交易員有機會用來套利，從而提升市場效率。

 

2. 交易與結算

穩定幣USDT被用做一種交易工具，可以迅速地從波動的數字貨幣轉換爲相對穩定的貨幣替代品，反之亦然。

 

相反，從數字貨幣交易所的角度來看，它們容許用戶提供相似美圓的交易和結算功能，而不依賴傳統的電匯。

 

所以，以USDT爲首的穩定幣導致交易所從傳統銀行合做夥伴關係中得以解脫。

 

值得一提的是，一部分穩定幣錢包掌握在加密貨幣交易所手中，意味着用戶主要在交易所綜合錢包之間轉移，不多提取。好比，新近的的一份報告挖掘獲得，80%的Tether代幣USDT大約被三百個實體掌控，在這其中大部分是數字貨幣交易所。

 

3. DeFi應用

提供至關普遍的場景，好比去中心化數字貨幣交易所、借貸市場、衍生品和鏈上資產管理。在上述應用中，穩定幣USDT起着舉足輕重的做用。

 

4. 其餘應用

例如支付、工資和匯款，截至當前，還未引起過多注意。還有，穩定幣與Dapp的集成。

 

 

穩定幣USDT需求增長的緣由

 

受全球新冠疫情的影響，全球範圍內跨境支付、匯款、轉帳成本變高，可以爲跨境支付提供便利性的穩定幣吸引了一些圈外資金，導致穩定幣USDT需求進一步增長。

 

另外，在3月12日黑色星期四市場暴跌後，基於數字貨幣交易因此及場外交易平臺指望持有相關美圓資產，以USDT爲首的穩定幣需求不斷增加。

 

來自穩定幣穩定幣USDT宇宙內外的因素推進USDT的進一步發展，基於穩定幣USDT普遍的應用，第三方業務系統USDT充提幣需求激增，須要USDT支付接口快速對接。

 

以最近較火的區塊鏈企業錢包開放平臺爲例。

 

詳細的接口文檔以下：

 

原文連接：https://www.uduncloud.com/gateway-interface

一、目錄

1.一、生成地址

1.二、提幣

1.三、代付

1.四、交易回調

1.五、校驗地址合法性

1.六、獲取商戶支持幣種信息

二、接口明細

一、生成地址

1.1 場景說明

請求指定幣種地址,如要成功獲取地址,需先存在錢包,且錢包支持該幣種, 詳情參看

1.2 接口詳情

1.2.1 接口地址

接口詳情
URL	【/mch/address/create】
請求方式	POST

1.2.2 參數

1.2.2.1 參數說明

參數	類型	是否必填	說明	備註
timestamp	String	是	時間戳	見 驗籤說明
nonce	String	是	隨機數	見 驗籤說明
sign	String	是	簽名	見 驗籤說明
body	String	是	消息內容	json字符串，格式以下

[

    {

     "merchantId":"300015",

     "coinType":520,

     "callUrl":"http://localhost:8080/callBack"

    }

]

1.2.2.2 body參數字段

body參數名	類型	是否必填	說明
merchantId	String	是	商戶號
coinType	Integer	是	主幣種編號，見 附錄一
callUrl	String	是	回調地址，經過該接口建立的地址，之後關於該地址的充幣信息會經過您指定的回調地址通知您。具體示例見 交易回調接口
walletId	String	否	錢包編號,默認根據主錢包生成地址
alias	String	否	地址別名

1.2.2.3 示例

{

    "timestamp": 1535005047,

    "nonce": 10000,

    "sign": "a230def43c1a12b14393880a28d4e005",

    "body": "[{\"merchantId\":\"300015\",\"coinType\":520,\"callUrl\":\"http://localhost:8080/callBack\"}]" 

}

1.2.3 返回狀態碼錶

code	解釋
200	成功
4005	非法參數
4001	商戶不存在
4169	商戶已禁用
4162	簽名錯誤
4175	錢包編號錯誤
4017	商戶沒有建立錢包
4176	錢包未添加支持該幣種
4166	商戶沒有配置套餐
4168	商戶地址達到上限
4045	幣種信息錯誤
-1	獲取地址失敗

1.3 調取示例

1.3.1 成功

{

    "data":{

        "coinType":520,

        "address":"0xbe4e3699cb870bc95365fe04a187dd279a651a58"

    },

    "message":"SUCCESS",

    "code":200

}

1.3.2 失敗

{

    "code": "4101",

    "message": "SIGN_MSG_ERROR"

}

二、發送提幣申請

2.1 場景說明

提幣申請

2.2 接口詳情

2.2.1 接口地址

接口詳情
URL	【/mch/withdraw】
請求方式	POST

2.2.2 參數

2.2.2.1 參數說明

參數	類型	是否必填	說明	備註
timestamp	String	是	時間戳	見 驗籤說明
nonce	String	是	隨機數	見 驗籤說明
sign	String	是	簽名	見 驗籤說明
body	String	是	消息內容	json字符串，格式以下

[

    {

        "address":"raadSxrUhG5EQVCY75CSGaVLWCeXd6yH6s",

        "amount":"0.11",

        "merchantId":"100109",

        "mainCoinType":"144",

        "coinType":"144",

        "callUrl":"http://localhost:8080/mch/callBack",

        "businessId":"15",

        "memo":"10112"

    }

]

2.2.2.2 body參數字段

body參數名稱	是否必填	類型	說明
address	是	String	提幣地址
amount	是	String	提幣數量
merchantId	是	String	商戶號
mainCoinType	是	String	主幣種編號 （見 附錄一 ）
coinType	是	String	子幣種編號 （見 附錄一 ）
callUrl	是	String	回調地址，經過該callUrl告知您該筆提幣交易的狀態,具體示例見 交易回調接口
businessId	是	String	業務id，必須保證該字段在系統內惟一，若是重複，則該筆審覈錢包不會接收。
memo	否	String	備註,XRP和EOS，這兩種幣的提幣申請該字段可選，起他類型幣種不填

2.2.2.3 示例

{

  "timestamp": 1535005047,

  "nonce": 100000,

  "sign": "6df1512ee650431632ce1541a6b064e1",

  "body": "[{\"address\":\"raadSxrUhG5EQVCY75CSGaVLWCeXd6yH6s\",\"amount\":\"0.11\",\"merchantId\":\"100109\",\"mainCoinType\":\"144\",\"coinType\":\"144\",\"callUrl\":\"http://localhost:8080/callBack\",\"businessId\":\"15\",\"memo\":\"10112\"}]" 

}

2.2.3 返回狀態碼錶

code	解釋
200	成功
4005	非法參數
4598	傳入body中的list對象中的全部merchantId必須保持一致
4001	商戶不存在
4169	商戶已被禁用
4183	到帳地址異常
4193	EOS金額小數點後超過4位長度
4034	未找到該幣種信息

2.3.1 成功

{

    "message":"SUCCESS",

    "code":200

}

2.3.2 失敗

{

    "code": "4101",

    "message": "SIGN_MSG_ERROR"

}

三、代付

3.1 場景說明

代付,發送自動付款申請，未設置代付信息或代付失敗則進入審覈狀態。

3.2 接口詳情

3.2.1 接口地址

接口詳情
URL	【/mch/withdraw/proxypay】
請求方式	POST

3.2.2 參數

3.2.2.1 參數說明

參數	類型	是否必填	說明	備註
timestamp	String	是	時間戳	見 驗籤說明
nonce	String	是	隨機數	見 驗籤說明
sign	String	是	簽名	見 驗籤說明
body	String	是	消息內容	JSON字符串，格式以下

[

  {

      "address":"raadSxrUhG5EQVCY75CSGaVLWCeXd6yH6s",

      "amount":"0.1",

      "merchantId":"100146",

      "mainCoinType":"144",

      "coinType":"144",

      "callUrl":"http://localhost:8080/callBack",

      "businessId":"571001",

      "memo":"10112"

  }

]

3.2.2.2 body參數說明

body參數名稱	類型	是否必填	說明
merchantId	String	是	商戶號
address	String	是	提幣地址
mainCoinType	String	是	主幣種編號，見 附錄一
coinType	String	是	子幣種編號，見 附錄一
amount	String	是	交易數量
callUrl	String	是	回調地址,提幣（審覈、交易）結果將經過該地址進行回調，具體示例見 交易回調接口
businessId	String	是	業務id，必須保證該字段在系統內惟一，若是重複，則該筆提幣錢包將不會進行接收
memo	String	否	備註,XRP和EOS，這兩種幣的提幣申請該字段可選，起他類型幣種不填

3.2.2.2 示例

{

    "timestamp": 1535005047,

    "nonce": 100000,

    "sign": "e1bee3a417b9c606ba6cedda26db761a",

    "body": "[{\"address\":\"raadSxrUhG5EQVCY75CSGaVLWCeXd6yH6s\",\"amount\":\"0.1\",\"merchantId\":\"100146\",\"mainCoinType\":\"144\",\"coinType\":\"144\",\"callUrl\":\"http://localhost:8080/callBack\",\"businessId\":\"571001\",\"memo\":\"10112\"}]"

}

3.2.3 返回狀態碼錶

code	解釋
200	成功
4005	非法參數
4001	商戶不存在
4166	商戶沒有配置套餐
4169	商戶已被禁用
4612	簽名錯誤
4163	簽名信息錯誤
569	無效的地址
571	已存在審覈記錄,將再也不進行處理
581	非法提幣金額
554	商戶不支持該幣種

3.3 調取示例

3.3.1 成功

{

    "message":"SUCCESS",

    "code":200

}

3.3.2 失敗

{

    "code": "4101",

    "message": "SIGN_MSG_ERROR"

}

四、交易回調接口

4.1 場景說明

網關收到交易處理結果，調用商戶提供的回調接口，通知商戶具體變化信息。該接口網關發送給您指定的回調地址的內容，處理您的業務信息。 分充值回調和提幣回調，其中提幣最多會進行兩次回調（審覈回調+交易結果回調）

4.2 接口詳情

4.2.1 接口地址

接口詳情
URL
請求方式	POST

4.2.2 參數

4.2.2.1 參數說明

參數	類型	是否必填	說明	備註
timestamp	String	是	時間戳	見 驗籤說明
nonce	String	是	隨機數	見 驗籤說明
sign	String	是	簽名	見 驗籤說明
body	String	是	消息內容	JSON字符串，格式以下

{

    "address":"DJY781Z8qbuJeuA7C3McYivbX8kmAUXPsW",

    "amount":"12345678",

    "blockHigh":"102419",

    "coinType":"206",

    "decimals":"8",

    "fee":"452000",

    "mainCoinType":"206",

    "status":3,

    "tradeId":"20181024175416907",

    "tradeType":1,

    "txId":"31689c332536b56a2246347e206fbed2d04d461a3d668c4c1de32a75a8d436f0",

    "businessId":"",// 提幣回調爲提幣接口傳入的businessId，充幣無值

    "memo":""

}

4.2.2.2 body參數說明

body參數名稱	類型	說明
address	String	地址
amount	String	交易數量，根據幣種精度獲取實際金額，實際金額=amount/pow(10,decimals)，即實際金額等於amount除以10的decimals次方
fee	String	礦工費，根據幣種精度獲取實際金額，實際金額獲取同上
decimals	String	幣種精度
coinType	String	子幣種編號,見 附錄一
mainCoinType	String	主幣種編號,見 附錄一
businessId	String	業務編號，提幣回調時爲提幣請求時傳入的，充幣回調無值
blockHigh	String	區塊高度
status	Integer	狀態，見 回調接口狀態說明
tradeId	String	交易流水號
tradeType	Integer	交易類型,見 回調接口交易類型說明
txid	String	區塊鏈交易哈希
memo	String	備註，XRP和EOS（見 附錄一 ），這2種類型幣的充提幣可能有值

4.2.2.2 示例

{

    "timestamp": 1535005047,

    "nonce": 100000,

    "sign": "e1bee3a417b9c606ba6cedda26db761a",

    "body": "{\"address\":\"DJY781Z8qbuJeuA7C3McYivbX8kmAUXPsW\",\"amount\":\"12345678\",\"blockHigh\":\"102419\",\"coinType\":\"206\",\"decimals\":\"8\",\"fee\":\"452000\",\"mainCoinType\":\"206\",\"status\":3,\"tradeId\":\"20181024175416907\",\"tradeType\":1,\"txId\":\"31689c332536b56a2246347e206fbed2d04d461a3d668c4c1de32a75a8d436f0\"}"

}

五、校驗地址合法性

5.1 場景說明

校驗地址的合法性,添加地址、提幣申請等場景時可先校驗地址合法性，參看 校驗規則

5.2 接口詳情

5.2.1 接口地址

接口詳情
URL	【/mch/check/address】
請求方式	Post

5.2.2 參數

5.2.2.1 參數說明

參數	類型	是否必填	說明	備註
timestamp	String	是	時間戳
nonce	String	是	隨機數
sign	String	是	簽名
body	String	是	消息內容	JSON字符串，格式以下

{

    "merchantId":200000,

    "mainCoinType":"206",

    "address":"DJY781Z8qbuJeuA7C3McYivbX8kmAUXPsW"

}

5.2.2.2 body參數說明

body參數名稱	類型	是否必填	說明
merchantId	Long	是	商戶號
mainCoinType	String	是	主幣種編號，見 附錄一
address	String	是	需校驗的地址

5.2.2.2 示例

{

    "timestamp": 1535005047,

    "nonce": 100000,

    "sign": "e1bee3a417b9c606ba6cedda26db761a",

    "body": "[{\"merchantId\":200000,\"mainCoinType\":\"206\",\"address\":\"DJY781Z8qbuJeuA7C3McYivbX8kmAUXPsW\"}]"

5.2.3 返回狀態碼錶

code	解釋
200	成功
4005	非法參數
4162	簽名錯誤
4165	地址不合法

5.3 調取示例

5.3.1 成功

{

    "code":200,

    "message":"SUCCESS"

}

5.3.2 失敗

{

    "code":4005,

    "message":"PARAM_ERROR"

}

六、獲取商戶支持的幣種信息

 

6.1 場景說明

獲取商戶支持的幣種,以及餘額

 

6.2 接口詳情

 

6.2.1 接口地址

接口詳情
URL	【/mch/support-coins】
請求方式	POST

6.2.2 參數

6.2.2.1 參數說明

參數	類型	是否必填	說明
timestamp	String	是	時間戳
nonce	String	是	隨機數
sign	String	是	簽名
body	String	是	消息內容

6.2.2.2 body參數說明

body參數名稱	類型	是否必填	說明
merchantId	Long	是	商戶號
showBalance	Boolean	是	是否查詢餘額，false不獲取，true獲取

6.2.2.3 示例

{

    "timestamp": 1535005047,

    "nonce": 100000,

    "sign": "e1bee3a417b9c606ba6cedda26db761a",

    "body": "{\"merchantId\":\"200032\",\"showBalance\":true}"

}

 

6.2.3 返回狀態碼錶

狀態碼	解釋
200	成功
4005	body參數錯誤

6.3 調取示例

6.3.1 成功

{

    "code": 200,

    "message": "SUCCESS",

    "data":[

        {

            "name": "BTC", // 幣種別名

            "coinName":"Bitcoin", // 幣種全稱

            "symbol":"BTC", // 幣種單位

            "mainCoinType":"0", //主幣種類型

            "coinType":"0", // 幣種類型

            "decimals":"8", // 幣種精度

            "tokenStatus":"0", // 0： 主幣 1：代幣

            "mainSymbol":"BTC", //主幣種單位

            "balance":"0", // 幣種餘額

            "logo":"http://bipay-admin.oss-cn-hangzhou.aliyuncs.com/bipay-admin-release/coin-logo/BTC.png" // 幣種log地址

        },

        {

            "name": "ETH", // 幣種別名

            "coinName":"Ethereum", // 幣種全稱

            "symbol":"ETH", // 幣種單位

            "mainCoinType":"60", //主幣種類型

            "coinType":"60", // 幣種類型

            "decimals":"18", // 幣種精度

            "tokenStatus":"0", // 0： 主幣 1：代幣

            "mainSymbol":"ETH", //主幣種單位

            "balance":"0", // 幣種餘額

            "logo":"https://bipay-admin.oss-cn-hangzhou.aliyuncs.com/bipay-admin-release/coin-logo/ETH.png" // 幣種log地址

        }

    ]

}

6.3.2 失敗

{

    "code":4005,

    "message":"BGS_ILLEGAL_PARAMETER"

}

附錄一

主幣種編號	子幣種編號	幣種簡稱	幣種英文名	幣種中文名稱	精度
0	0	BTC	Bitcoin	比特幣	8
60	60	ETH	Ethereum	以太坊	18
0	31	USDT	Tether USD	泰達幣	8
520	520	CNT	CNT	測試幣	18
5	5	DASH	DASH	達世幣	8
133	133	ZEC	ZEC	大零幣	8
145	145	BCH	Bitcoincash	比特幣現金	8
61	61	ETC	Ethereum Classic	以太坊經典	18
2	2	LTC	LTC	萊特幣	8
2301	2301	QTUM	QTUM	量子鏈幣	8
502	502	GCC	GalaxyChain		8
60	合約地址	eth代幣	eth代幣		根據代幣具體狀況而定
144	144	XRP	Ripple	瑞波幣	6
194	194	EOS	EOS	柚子幣	4
194	194	EOS	EOS	柚子幣	4
2304	2304	IOTE	IOTE	IOTE	8
2303	2303	VDS	Vollar	Vollar幣	8

回調接口狀態說明

狀態	說明
0	待審覈
1	審覈成功
2	審覈駁回
3	交易成功
4	交易失敗

回調接口交易類型說明

狀態	說明
1	充幣回調
2	提幣回調

驗籤說明

爲了保證商戶傳送到優盾的參數信息不被惡意篡改，網關爲商戶接口提供Md5加密摘要認證。商戶可用基礎加密參數：時間戳、隨機數、簽名密鑰(商戶惟一的APIKEY)、請求明文參數按指定順序排列進行Md5加密，產生一個驗籤串sign，商戶請求網關接口時，帶上參數時間戳、隨機數、請求明文參數、sign做爲參數。網關拿到相應的參數以一樣的方式進行簽名驗籤。同理，網關請求商戶也以一樣的方式進行身份驗證。

sign=md5(body + key + nonce + timestamp)

key爲接口受權碼APIKEY，由網關分配給商戶，加密字段順序不能錯誤

 

幣種地址校驗規則

主幣種類型	幣種簡稱	幣種英文名稱	幣種中文名稱	地址前綴	地址長度限制區間
0	BTC	Bitcoin	比特幣	1或者3	[26,36]
60	ETH	Ethereum	以太坊	0x	[42]
145	BCH	Bitcoincash	比特幣現金	1	[26,36]
61	ETC	EthereumClassic	以太坊經典	0x	[42]
2	LTC	Litecoin	萊特幣	L或者M	[26,36]
508	GX	GX		G	[26,36]
503	NBTC	NBTC		N	不限制
99	STO	STO	證券型通證發行	S	不限制
5	DASH	DASH	達世幣	X	[26,36]
2301	QTUM	QTUM	量子鏈幣	Q	[26,36]
133	ZEC	ZCash	大零幣	t1	不限制
144	XRP	Ripple	瑞波幣	r	[34]