跳转到主要内容

1. 接口概述

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

2. 请求参数

参数名必选类型说明
appIdLong业务ID(后台获取)
tranTypeString支付类型(可选),如果传入则按支付类型筛选,详见tranType说明
tranCodeString交易类型(可选),如果传入则按交易类型筛选,详见tranCode说明
signString签名

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