获取支付配置
728字约2分钟
注意
阅读该接口文档前,务必先查看 接口说明
简要描述:
- 获取商户的支付配置信息,包括支付方式、费率、账期、限额等
URL:/common/payment/config
参数:
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | Long | 业务ID(后台获取,需要根据URL中的币种传递对应的业务ID) |
| tranType | 否 | String | 交易类型(如:BANK_ACCOUNT、BANK_CARD、EWALLET等),如果传入则只返回该交易类型的配置 |
| tranCode | 否 | Integer | 交易代码,15=代付(出款),20=收款(代收),如果传入则只返回该交易类型的配置 |
| sign | 是 | String | 请求签名,使用商户密钥进行RSA签名 |
返回data参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| userId | Long | 用户ID |
| configs | Array | 配置列表 |
| sign | String | 响应签名 |
configs[] 配置项说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| appId | Long | 应用ID |
| appName | String | 应用名称 |
| tranCode | Integer | 交易类型:15=代付,20=收款 |
| tranType | String | 支付类型(交易方式),如:BANK_ACCOUNT、BANK_CARD、EWALLET等 |
| currNo | String | 币种编码(如:USD、CNY、MXN) |
| payMethods | Array | 支付方式列表 |
| feeRate | Object | 费率信息 |
| settlement | Object | 账期信息 |
| limit | Object | 限额信息 |
| supportRefund | Boolean | 是否支持退款(只有USD+代收+CREDIT_CARD才支持退款) |
payMethods[] 支付方式说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | String | 支付方式编码 |
| name | String | 支付方式名称 |
feeRate 费率信息说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| feeType | Integer | 手续费收取方式:0=外扣,1=内扣 |
| feeMode | Integer | 手续费收款类型:0=比率,1=按笔,2=阶梯,3=底价 |
| feeRate | String | 手续费率(当feeMode=0时) |
| feeFixedValue | String | 固定手续费(当feeMode=1时) |
| feeMinValue | String | 最小手续费 |
| feeMaxValue | String | 最大手续费 |
| degrees | Array | 阶梯费率列表(当feeMode=2时) |
feeRate.degrees[] 阶梯费率说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| start | Long | 区间开始金额 |
| end | Long | 区间结束金额 |
| value | String | 区间费率 |
| name | String | 区间名称 |
settlement 账期信息说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| stlMode | Integer | 结算方式:0=D0(自然天),1=TN(工作日),2=WN(周结),3=MN(月结) |
| stlCycle | Integer | 结算周期值 |
limit 限额信息说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| singleMinAmount | String | 单笔最小金额 |
| singleMaxAmount | String | 单笔最大金额 |
request
{
"appId": 2054,
"sign": "your_signature_here"
}response
{
"status": "1",
"error": "00000000",
"msg": "",
"data": {
"userId": 672,
"configs": [
{
"appId": 2054,
"appName": "jiwushanghu_USDT1",
"tranCode": 15,
"tranType": "EWALLET",
"currNo": "USDT",
"payMethods": [
{
"code": "TRX",
"name": "TRX"
},
{
"code": "BSC",
"name": "USDT(BEP20)"
}
],
"feeRate": {
"feeType": 0,
"feeMode": 0,
"feeRate": "0.4",
"feeFixedValue": "4",
"feeMinValue": "0",
"feeMaxValue": "100000000000"
},
"settlement": {
"stlMode": 0,
"stlCycle": 0
},
"limit": {
"singleMinAmount": "0",
"singleMaxAmount": "999999999"
},
"supportRefund": false
}
],
"sign": "response_signature_here"
}
}带筛选条件的请求示例
request
{
"appId": 2054,
"tranType": "BANK_CARD",
"tranCode": 20,
"sign": "your_signature_here"
}response
{
"status": "1",
"error": "00000000",
"msg": "",
"data": {
"userId": 672,
"configs": [
{
"appId": 2065,
"appName": "jiwushanghu_MXN1",
"tranCode": 20,
"tranType": "BANK_CARD",
"currNo": "MXN",
"payMethods": [
{
"code": "OXXO",
"name": "OXXO"
}
],
"feeRate": {
"feeType": 1,
"feeMode": 0,
"feeRate": "0.2",
"feeFixedValue": "0",
"feeMinValue": "0",
"feeMaxValue": "100000000000"
},
"settlement": {
"stlMode": 0,
"stlCycle": 0
},
"limit": {
"singleMinAmount": "0.1",
"singleMaxAmount": "999999999"
},
"supportRefund": false
}
],
"sign": "response_signature_here"
}
}