跳到主要内容

收款方式

接入前请查看接口开放状态,并在目标环境确认账户权限。

操作方法与路径开放状态
查询收款方式GET /v1/payment-methods商户路由已确认

查询商户已开通且可用的收款方式,用于选择收款币种和付款网络。

请求、认证及错误响应遵循商户 API 通用约定。

Payment Methods Object​

Attributes​

属性类型说明
ipparray of objectsIPP 隐私支付支持的币种与网络组合;始终返回数组,没有可用组合时为 []
ipp[].currencystring收款币种:usdc、usdt
ipp[].chaininteger付款网络编号(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_transferobject[]直接 ERC-20 转账可用组合,为空时返回 []
erc20_transfer[].currencystring稳定币代码
erc20_transfer[].chainintegerEIP-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": []
}