注入抵押品

接口調用流程

注入抵押品页面調用流程如下：

獲取網絡及幣種 ➡️ 獲取抵押貨幣對匯率 ➡️ (輸入數量) ➡️ (支付成功) ➡️ (等待通知) ➡️ 加額成功/失敗

抵押之前，需要先 査詢客戶KYC狀態 和 査詢客戶卡狀態，根據出金用戶和入金用戶的KYC狀態及卡狀態，判斷是否可以抵押加額

注意：以下幾種情況，必定無法加額成功

• 出金用戶(客戶A) 或 入金用戶(客戶B)，KYC狀態未通過
• 出金用戶(客戶A)，未開卡或卡未激活
• 入金用戶(客戶B)，已開卡但卡未激活

抵押方式

注入抵押品有兩種方式：

• 對接BlockATM收銀台，喚起客戶錢包
• 獲取收款錢包地址，轉換成二維碼，客戶自主掃碼

對接BlockATM收銀台

注意：調用 獲取網絡及幣種 接口，必須傳參數（apiKeyList），否則，會獲取到不正確的網絡資訊

參考BlockATM的組件集成的說明文檔：Getting Started With Widget

給指定客戶加額

如果需要實現 客戶A 抵押加密貨幣，給 客戶B 帳戶加額（類似代理給下級客戶加額），可在初始化 BlockATM收銀台 時，通過 orderNo 字段 傳入 客戶B 的客戶編號

JavaScript

window.BlockATM.init(dom, {
  custNo: '**', 
  orderNo： 'B Customer Number',   /** Customer ID of the deposit user (Non-mandatory) */
  lang: 'en-US',  
  callback: ({type})=>{ 
  	/** Callback Method */
  }
})

獲取收款錢包地址

注意：調用 獲取網絡及幣種 接口，不需要傳參數，否則，會獲取到不正確的網絡資訊

獲取網絡接口，可拿到網絡對應的networkType和chainId参数，用于調用 增加額度 接口，獲取收款錢包地址，再轉換成二維碼展示在收銀台

相關接口

査詢客戶KYC狀態：/passToCredit.admin.AdminCardQueryDubboService.queryKycStatus

JSON

{
  customerNo: '***'  /** Customer Number */
}

査詢客戶卡狀態：/passToCredit.admin.AdminCardQueryDubboService.queryCardStatus

JSON

{
  customerNo: '***'  /** Customer Number
}

獲取網絡及幣種：/passToCredit.app.AppAssistDubboService.findNetworkAndCurrencyList

JSON

// Example of interface parameters for obtaining network and currency
{
    "apiKeyList": [
        "A2900C89-1083****",
        "F78DCE05-2AA7****"
    ]
    // The key of apiKeyList is the apiKey in the blockATM merchant backend. The apiKey for ERC20 and TRC20 are different, so there are two apiKeys
}

獲取抵押貨幣對匯率：/passToCredit.app.AppRateDubboService.findDepositExchangeRate

JSON

// Example of interface parameters for obtaining the exchange rate of collateral currency
{
    "tradeType": 7, // Fixed as 7
    "accountCurrency": "HKD",   // Account currency, currently fixed as HKD
    "accountId": 1001430,   // Account ID
    "customerNo": "86001307", // User number
    "paymentCurrency": "USDT"   // Currency of the digital currency used for collateral payment
}

響應字段解析

symbolId字段： 0表示固定匯率， 其他表示動態匯率。

如果是固定匯率：
取exchangeRate作為匯率計算；

如果是動態匯率：
取 rateRangeLevelList 字段，值為一個數組，例如：

JSON

[
  { "min": "0", "max": "10000", "rate": "7.711" },
  { "min": "10000", "max": "50000", "rate": "7.727" },
  { "min": "50000", "max": "500000", "rate": "7.750" }
]

如果用戶輸入的USDT幣種數量<=max, 則取當前區間的匯率；
如果USDT幣種數量大於最後一個層級的max，則取最後一個層級的匯率。

增加額度：/passToCredit.admin.AdminFundsTransferService.transferAmount

JSON

{
  bizType: '3',
  fromCustomerNo: '***',
  customerNo: '***',
  amount: '10',
  currency: 'USDT',
  networkType: 'ERC20',
  chainId: '1' 
}

监听抵押加额的结果

[監聽websocket通知]notice消息： bizType為 LIMIT_INCREASED_SUCCESSFULLY，表示加額成功。
[監聽websocket通知]notice消息： bizType為 LIMIT_INCREASED_FAILED，表示加額失敗。
[監聽websocket通知]notice消息： bizType為 LIMIT_INCREASED_TIMEOUT，表示加額超時。

常見問題

• 現在支援哪些抵押數字資產？
  回答：thereum(ERC20) 支援幣種：USDT、USDC。
  Tron(TRC20) 支援幣種：USDT。

• 支援哪些數字錢包注入抵押？
  回答：所有支援WalletConnect協議的錢包及Tronlink插件錢包均可支援。