收款方式
接入前请查看接口开放状态,并在目标环境确认账户权限。
| 操作 | 方法与路径 | 开放状态 |
|---|---|---|
| 查询收款方式 | GET /v1/payment-methods | 商户路由已确认 |
查询商户已开通且可用的收款方式,用于选择收款币种和付款网络。
请求、认证及错误响应遵循商户 API 通用约定。
Payment Methods Object
Attributes
| 属性 | 类型 | 说明 |
|---|---|---|
ipp | array of objects | IPP 隐私支付支持的币种与网络组合;始终返回数组,没有可用组合时为 [] |
ipp[].currency | string | 收款币种:usdc、usdt |
ipp[].chain | integer | 付款网络编号(EIP-155 chain ID),例如 56 表示 BNB Smart Chain 主网 |
每一项表示一个可用组合,不能将不同项的币种与网络自行交叉组合。同一组合不重复;没有可用收款方式时返回 {"ipp":[],"erc20_transfer":[]}。
对象示例
{
"ipp": [
{
"currency": "usdc",
"chain": 56
},
{
"currency": "usdc",
"chain": 137
},
{
"currency": "usdt",
"chain": 56
}
],
"erc20_transfer": []
}
收款方式分组
当前响应同时包含 ipp 和 erc20_transfer 两个数组;无可用组合的分组返回 []。每个分组元素均为 {currency, chain},分别表示币种与标准网络编号。直接 ERC-20 转账的组合不能从 IPP 分组推导,反之亦然。
| 属性 | 类型 | 说明 |
|---|---|---|
erc20_transfer | object[] | 直接 ERC-20 转账可用组合,为空时返回 [] |
erc20_transfer[].currency | string | 稳定币代码 |
erc20_transfer[].chain | integer | EIP-155 chain ID |
查询可用收款方式
GET /v1/payment-methods
返回当前商户的完整收款能力对象,不分页。
Attributes
无请求参数。
请求示例
GET /v1/payment-methods
Authorization: Bearer inv_test_...
返回示例
200 OK,直接返回 Payment Methods 对象。
{
"ipp": [
{
"currency": "usdc",
"chain": 56
},
{
"currency": "usdc",
"chain": 137
},
{
"currency": "usdt",
"chain": 56
}
],
"erc20_transfer": []
}