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。页面会直接显示要转的准确金额和地址。