注意

阅读该接口文档前，务必先查看 接口说明

简要描述：

• 获取商户的支付配置信息，包括支付方式、费率、账期、限额等

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"
  }
}