14.1 特殊费用配置新增

1、阶梯计费时，需要按阶梯个数分别新增，比如分三个阶梯，则需要请求三次接口，返回对应三个ID，变更时，送对应ID进行变更。

请求参数

Body 参数application/json

请求参数

reqBody

object (SpecialStlmAddRequestVO)

请求体

必需

applyNo

string

申请单编号

必需

mchtCode

string

内部商户号

必需

交易发起商户号

businessId

enum<string>

费用类型名称

必需

枚举值:

2301230223032304

tagType

enum<string>

费用周期类型

必需

枚举值:

ONETIMECYCLICITY

billingCycleVal

integer <int64>

循环周期值

必需

ledgerInst

string

费用收款方

必需

收取特殊费用的商户号或客户号

>= 0 字符<= 16 字符

feeInst

string

手续费承担方

必需

特殊费用这部分金额对应的交易手续费承担方，可以是交易商户或费用收款方自己承担，但仅支持由其中一方100%承担

>= 0 字符<= 16 字符

billingCycleType

string

结算周期类型

必需

目前仅支持按天D

cardIssuerCode

string

卡机构编号

可选

>= 0 字符<= 32 字符

cardType

enum<string>

卡种

必需

>= 0 字符<= 4 字符

枚举值:

000C000D000UXXXX

正则匹配:

^[XXXX|000C|000D|000U]*$

calcType

enum<string>

手续费计算方式

必需

>= 0 字符<= 1 字符

枚举值:

正则匹配:

^[0-1]*$

calcVal

integer <int64>

手续费费率值

必需

按比例时单位为%，按笔时单位为分

amtHighLt

integer <int64>

交易金额最高值

可选

阶梯计费时使用，单位分。

amtLowLt

integer <int64>

交易金额最低值

可选

阶梯计费时使用，单位分。

feeLowLimit

integer <int64>

手续费最低值

必需

保底手续费金额，单位分。无保底送0.

feeHighLimit

integer <int64>

手续费最高值

必需

封顶手续费金额，单位分。无封顶送9999999999。

示例

{
    "reqBody": {
        "applyNo": "string",
        "mchtCode": "string",
        "businessId": "2301",
        "tagType": "ONETIME",
        "billingCycleVal": 0,
        "ledgerInst": "string",
        "feeInst": "string",
        "billingCycleType": "string",
        "cardIssuerCode": "string",
        "cardType": "000C",
        "calcType": "0",
        "calcVal": 0,
        "amtHighLt": 0,
        "amtLowLt": 0,
        "feeLowLimit": 0,
        "feeHighLimit": 0
    }
}

返回响应

🟢200OK

application/json

Body

rspBody

object (SpecialStlmAddResponseVO)

可选

retCode

string

返回码

可选

retMsg

string

描述

可选

示例

{
    "rspBody": {
        "retCode": "string",
        "retMsg": "string"
    }
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found