API 路徑、欄位名稱、事件名稱和程式碼範例保持英文,與介面完全一致,可直接複製使用。
網絡
GET/v1/networks
列出您帳戶開通的網絡、每個網絡玩家怎麼付款,以及您的價格。用它在您自己的網站上顯示正確的網絡和最低金額,再帶著玩家選好的金額和網絡跳到支付頁面。
示例
const { body } = await icn("GET", "/v1/networks");
status, body = icn("GET", "/v1/networks")
200 OK
{
"networks": [
{
"asset": "tron:USDT",
"chain": "tron",
"token": "USDT",
"decimals": 6,
"mode": "standard",
"payment_page": true,
"fee_formula": "sum",
"deposit": { "fee_bps": 100, "min_fee": "0", "min_amount": "10000000" },
"payout": { "fee_bps": 50, "min_fee": "1500000", "min_amount": "20000000", "fee_mode": "on_top" }
},
{
"asset": "bsc:USDT",
"chain": "bsc",
"token": "USDT",
"decimals": 18,
"mode": "pro",
"payment_page": true,
"fee_formula": "sum",
"deposit": { "fee_bps": 100, "min_fee": "1000000000000000000", "min_amount": "10000000000000000000" },
"payout": { "fee_bps": 50, "min_fee": "1000000000000000000", "min_amount": "10000000000000000000", "fee_mode": "on_top" }
}
]
}欄位
| 欄位 | 類型 | 說明 |
|---|---|---|
asset | string · 必填 | 網絡和幣種,例如 tron:USDT。建支付單時放進 assets。 |
mode | string · 必填 | standard:玩家透過支付頁面按準確金額付款。pro:每位玩家有自己的充值地址。見Standard 和 Pro。 |
payment_page | boolean · 必填 | 支付頁面上是否提供這個網絡。 |
fee_formula | string · 必填 | sum:費率加網絡費。max:兩者取高(較早的合約)。 |
deposit | object · 必填 | fee_bps(您的費率,100 = 1%)、min_fee(網絡費)和 min_amount,按這個網絡現在的收款方式計算。 |
payout | object · 必填 | 代付的 fee_bps、min_fee、min_amount 和 fee_mode(on_top 或 deducted)。 |
- 金額都是代幣最小單位的整數(TRON 和 Ethereum 的 USDT 是 6 位小數,BSC 是 18 位)。
- 在後台改了網絡(切換 Standard 或 Pro、開通新網絡),這裡馬上反映,所以請用它來讀,不要把網絡寫死。
- 某個金額的準確手續費請用報價。
常見流程(Standard)
- 在您的網站顯示
payment_page: true的網絡和它們的deposit.min_amount。 - 玩家選網絡、輸入金額並確認。
- 用這個
amount和assets: ["tron:USDT"]建支付單,把玩家跳到它的url。頁面會直接顯示要轉的準確金額和地址。