公共參數

0.1 公共參數（所有API接口都帶的參數）

0.2 業務參數body的組成規則

將業務參數轉變為JSON字符串之後，再用base64編碼後得到的結果。例如：您的業務參數轉化為json之後是 {"chainType":160,"callUrl":"http:\/\/xxx.com\/ubao_callback.html"}，將這個JSON字符串再用base64編碼，得到的結果：eyJtYWluQ29pblR5cGUiOjE2MCwiY2FsbFVybCI6Imh0dHA6XC9cL3h4eC5jb21cL3ViYW9fY2FsbGJhY2suaHRtbCJ9 ，即是body的值

0.3 簽名規則

將 body、api_key、nonce、timestamp 這4個字符串按照這裏的順序連接起來，轉換為md5，即可得到簽名。 商戶號以及api_key ，在用戶中心獲取

0.4 返回值

參見錯誤代碼

0.5 異步通知

0.5.1 異步通知驗簽及字段

異步通知，同樣由body、nonce、timestamp、sign構成。其中 body 是用 base64編碼過的。將body、api_key 、nonce、timestamp 按此處順序連接起來，再經過MD5加密，即可得到簽名。將此簽名與返回的 sign 對比，如果一致，則驗簽成功。將body經過 base64解碼後，即可得到json字符串，裏邊是通知的內容。

0.5.2 異步通知類型

異步通知，分為3類，都使用同一個回調地址，即生成地址時填寫的回調地址。用 body 中的 callbackType 字段加以區分。這三個種類是：充幣（recharge）、提幣或轉賬(transfer)、余額變動（balance），當body 中的 callbackType = recharge 時，說明這是一個充幣的通知，其他2種類推。

1、生成地址

1.1 場景說明

生成指定鏈的地址,如要成功生成地址,需要先添加過此鏈 調試工具 、SDK

1.2 接口地址

/mch/address/create

1.3 body參數

1.4 成功後返回

{"code":200,"message":"SUCCESS","address":"TQcK2oKpeVAE1mvYEudYJHgCr47F5ba8hk","chainType":160}

1.5 失敗後返回

參見錯誤代碼

2、提幣

2.1 場景說明

提幣申請，只能是歸集錢包。收款錢包，請使用歸集功能。

2.2 接口地址

/mch/withdraw

2.3 body參數

2.4 成功後返回

{"code":200,"message":"SUCCESS"}

2.5 失敗後返回

參見錯誤代碼

3、校驗地址合法性

3.1 場景說明

如果不確定自己提交的地址是否符合要求，可以先校驗合法性

3.2 接口地址

/mch/address/check

3.3 body參數

3.4 成功後返回

{"code":200,"message":"SUCCESS"}

3.5 失敗後返回

參見錯誤代碼

4、添加觀察錢包

4.1 場景說明

添加一個外部錢包的觀察地址

4.2 接口地址

/mch/address/add

4.3 body參數

4.4 成功後返回

{"code":200,"message":"SUCCESS"}

4.5 失敗後返回

參見錯誤代碼

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

5.1 場景說明

獲取商戶支持的幣種

5.2 接口地址

/mch/coins

5.3 body參數

5.4 成功後返回

{"code":200,"message":"SUCCESS","coins":"[]"}

5.5 失敗後返回

參見錯誤代碼

6、歸集到歸集錢包

6.1 場景說明

將收款錢包中的余額，歸集到歸集錢包

6.2 接口地址

/mch/address/pooling

6.3 body參數

6.4 成功後返回

{"code":200,"message":"SUCCESS"}

6.5 失敗後返回

參見錯誤代碼

7、驗證地址所有權

7.1 場景說明

在DAPP中，獲得地址後，還需要驗證地址所有權，防止用觀察錢包來登錄，類似情況下，需要來驗證所有權。如果返回結果result=true，說明是地址的主人

7.2 接口地址

/mch/address/verify

7.3 body參數

7.4 成功後返回

{"code":200,"message":"SUCCESS","result":"true"}

7.5 失敗後返回

參見錯誤代碼

8、充幣異步通知

8.1 場景說明

UBAO檢測到收款地址充幣後，將會通知該地址留下的回調URL。通知內容為：nonce、timestamp、sign、body，簽名驗證方式，與API相同。body需要base64解碼。 調試工具 、SDK

8.3 body參數

8.4 成功後返回

SUCCESS

8.5 失敗後返回

如果您的業務處理成功，請返回 SUCCESS 。如果你的業務處理失敗，可以返回 FAIL 或其他值。如果沒有返回 SUCCESS，UBAO將會在5、15、30分鐘再次回調，3次都失敗的話，將會放棄。需要的話，可在用戶中心手動回調。

9、提幣、轉賬異步通知

9.1 場景說明

當您提幣或轉賬（只能通過歸集錢包），UBAO處理之後，會通過此歸集錢包留下的回調URL，通知您。通知內容為：nonce、timestamp、sign、body，簽名驗證方式，與API相同。body需要base64解碼 調試工具 、SDK

9.3 body參數

9.4 成功後返回

SUCCESS

9.5 失敗後返回

如果您的業務處理成功，請返回 SUCCESS 。如果你的業務處理失敗，可以返回 FAIL 或其他值。如果沒有返回 SUCCESS，UBAO將會在5、15、30分鐘再次回調，3次都失敗的話，將會放棄。需要的話，可在用戶中心手動回調。

10、余額變動通知

10.1 場景說明

UBAO檢測到余額變動時，會通過此地址留下的回調URL，通知您變化。通知內容為：nonce、timestamp、sign、body，簽名驗證方式，與API相同。body需要base64解碼 調試工具 、SDK

10.3 body參數

10.4 成功後返回

SUCCESS

10.5 失敗後返回

如果您的業務處理成功，請返回 SUCCESS 。如果你的業務處理失敗，可以返回 FAIL 或其他值。如果沒有返回 SUCCESS，UBAO將會在5、15、30分鐘再次回調，3次都失敗的話，將會放棄。需要的話，可在用戶中心手動回調。

幣種編號