跳转到主要内容

​
1. 接口概述

  • 根据应用ID查询商户的可用支付配置信息，包括支付方式、费率、账期等配置
URL： /common/payment/config HTTP Method： POST Content-Type： application/json
  1. 请求需要进行签名验证，签名算法与其他接口一致
  2. tranType和tranCode为可选参数，用于筛选特定类型的支付配置
  3. 如果应用没有配置支付产品，返回的configs列表为空
  4. 响应数据也会进行签名，签名与其他方法相同，但要注意该接口返回数据存在多级嵌套。
  5. 如果传入币种为收银台，则会返回该用户下的所有可用app支付配置信息

​
2. 请求参数

参数名必选类型说明
appId是Long业务ID（后台获取）
tranType否String支付类型（可选），如果传入则按支付类型筛选，详见tranType说明
tranCode否String交易类型（可选），如果传入则按交易类型筛选，详见tranCode说明
sign是String签名

​
3. 返回参数

参数名类型说明
userIdLong用户ID
configsList<PaymentConfig>配置列表
signString签名
PaymentConfig对象说明：
参数名类型说明
appIdLong应用ID
appNameString应用名称
tranCodeString交易类型：pay=代付，collect=收款
tranTypeString支付类型（交易方式），详见tranType说明
currNoString币种编码（如USD, CNY）
payMethodsList<PayMethod>支付方式信息列表
feeRateFeeRate费率信息
settlementSettlement账期信息
supportRefundBoolean是否支持退款，详见退款支持说明
PayMethod对象说明：
参数名类型说明
inBankCodeString支付方式编码（inBankCode）
nameString支付方式名称
limitLimit支付方式限额信息
Limit对象说明：
参数名类型说明
singleMinAmountString单笔最小金额
singleMaxAmountString单笔最大金额
FeeRate对象说明：
参数名类型说明
feeTypeInteger手续费收取方式，详见feeType说明
feeModeInteger手续费收款类型，详见feeMode说明
feeRateString手续费率
feeFixedValueString固定手续费
degreesList<FeeDegree>阶梯费率列表（如果fee_mode=2）
FeeDegree对象说明：
参数名类型说明
startLong区间开始
endLong区间结束
valueString区间值（阶梯费率）
nameString区间名称
Settlement对象说明：
参数名类型说明
stlModeString结算方式，详见stlMode说明
stlCycleInteger结算周期值

​
4. 请求与返回示例

请求示例： 
{
  "appId": 2065,
  "sign": "PjQFVs4HxYM+skZ+9+O6LzrmgAeDRn6YgaM9ka+kynv8WH36HU6soMGWSV0GiO5ApPMdnpWbRdGt2jkcTFQ4+ZZ/2JxJsV0MGbwH5EGCxXb5vJar2v3l43WwpI9DDwpSjpYqrCA+XlXMA2oD3ZuOsqTKa49E2EgEhWa9mvS/5id+R6V03Zf1wy/sEsFya2zLVF2jK9zRVpQ+pOgAlT++EUPHzMtnAkfj2/CcSFE8Pl0v//HCcw/5dzLFIgpoUH/h6xSgzinndCQVA6Yy4JX9av/K554GpHHE1jw+PqZSW5JbYss/XpT2ltb3ieUdhiqvEHM9NGncBlWptk1KmDywKg\u003d\u003d"
}
成功返回示例： 
{
  "status": "1",
  "error": "00000000",
  "msg": "",
  "data": {
    "userId": 672,
    "configs": [{
      "appId": 2065,
      "appName": "jiwushanghu_MXN1",
      "tranCode": "pay",
      "tranType": "BANK_ACCOUNT",
      "currNo": "MXN",
      "payMethods": [{
        "inBankCode": "ACCENDO_BANCO",
        "name": "ACCENDO_BANCO",
        "limit": {
          "singleMinAmount": "3",
          "singleMaxAmount": "2000"
        }
      }, {
        "inBankCode": "ABC_CAPITAL",
        "name": "ABC_CAPITAL",
        "limit": {
          "singleMinAmount": "3",
          "singleMaxAmount": "2000"
        }
      }],
      "feeRate": {
        "feeType": 1,
        "feeMode": 1,
        "feeRate": "0",
        "feeFixedValue": "8.8"
      },
      "settlement": {
        "stlMode": "WN",
        "stlCycle": 4
      },
      "supportRefund": false
    }, {
      "appId": 2065,
      "appName": "jiwushanghu_MXN1",
      "tranCode": "collect",
      "tranType": "QR",
      "currNo": "MXN",
      "payMethods": [{
        "inBankCode": "CASH",
        "name": "Pay Cash",
        "limit": {
          "singleMinAmount": "5.1",
          "singleMaxAmount": "2000"
        }
      }],
      "feeRate": {
        "feeType": 1,
        "feeMode": 0,
        "feeRate": "0.035",
        "feeFixedValue": "0.2"
      },
      "settlement": {
        "stlMode": "TN",
        "stlCycle": 2
      },
      "supportRefund": false
    }, {
      "appId": 2065,
      "appName": "jiwushanghu_MXN1",
      "tranCode": "collect",
      "tranType": "VA",
      "currNo": "MXN",
      "payMethods": [{
        "inBankCode": "CLABE",
        "name": "CLABE",
        "limit": {
          "singleMinAmount": "5.1",
          "singleMaxAmount": "2000"
        }
      }],
      "feeRate": {
        "feeType": 1,
        "feeMode": 0,
        "feeRate": "0.035",
        "feeFixedValue": "0.2"
      },
      "settlement": {
        "stlMode": "TN",
        "stlCycle": 2
      },
      "supportRefund": false
    }, {
      "appId": 2065,
      "appName": "jiwushanghu_MXN1",
      "tranCode": "collect",
      "tranType": "VA",
      "currNo": "MXN",
      "payMethods": [{
        "inBankCode": "CLABE",
        "name": "CLABE",
        "limit": {
          "singleMinAmount": "5.1",
          "singleMaxAmount": "2000"
        }
      }],
      "feeRate": {
        "feeType": 1,
        "feeMode": 0,
        "feeRate": "0.035",
        "feeFixedValue": "0.2"
      },
      "settlement": {
        "stlMode": "TN",
        "stlCycle": 2
      },
      "supportRefund": false
    }],
    "sign": "Uw3xtKg3c772USUDvd5SDv9HjRU/WUAco/UJk+obJckJttwHyxNMfFVr1ADg2TDh2A+1VF5Klba2zmJ3L6DLkv+VXBUvHvvXPLxDLPnRXCzdp0wIxMeCdXZgvbFvtXB/teCOUpN0CocBkVmFtlE6uPoL74bj9l40ZqeDlHLRRbK+BS8d+0zDURINeQLFCTnvgygZof1GjfY6jbYfwfVnY9iJwjpYOc/+InPHSQJpzeVPw4c8fPK3V3rfzdwg1trpwgqnMYOFl1sr+t8ShkUiCpOBRb9E2iVM14cXbHrk3DqYO5p2pf6Ol0zeVMwAQG+oH66gGUCQT4DRcgWHFTtZtg=="
  }
}
错误响应示例： 
{
  "status": "0",
  "error": "1002",
  "msg": "Please configure the merchant public key"
}

​
5. 返回参数详细说明

​
tranType（支付类型）

值说明
BANK_TRANSFER银行转账
BANK_ACCOUNT银行账户
BANK_CARD银行卡
EWALLET电子钱包
UPIUPI

​
tranCode（交易类型）

值说明
pay代付
collect收款

​
feeType（手续费收取方式）

值说明
0外扣（手续费从余额账户扣除）
1内扣（手续费从订单金额内扣除）

​
feeMode（手续费收款类型）

值说明
0比率
1按笔
2阶梯
3底价

​
stlMode（结算方式）

值说明
D0自然天
TN工作日
WN周结
MN月结

​
supportRefund（退款支持）

退款功能仅对以下支付方式组合支持：
币种支付类型(payType)支付编码(inBankCode)
USDBANK_TRANSFERCREDIT_CARD
USDEWALLETGOOGLE_PAY
USDEWALLETAPPLE_PAY
Last modified on April 17, 2026