13.1.1 手续费营销商户报名

该接口是给商户报名参加某项活动

请求参数

Body 参数application/json

reqBody

object

请求体

必需

accumulationAmount

number

额度，单位：元

可选

>= 0.01<= 100000000000000000

accumulationAmountShareSwitch

string

是否共享额度

必需

优惠额度（累计金额）是否共享开关，0：否；1：是；

accumulationType

enum<string>

额度累计类型

必需

枚举值:

actRuleList

array [object {14}]

子规则信息

必需

activityId

number

活动id

可选

agentMchtCode

string

拓展商户编号

可选

这是扩展方编号

beginDate

string <date-time>

活动开始时间

必需

yyyy-MM-dd HH:mm:ss

endDate

string <date-time>

活动结束时间

必需

yyyy-MM-dd HH:mm:ss

billingCycle

string

结算周期

可选

bizReqNo

string

业务请求流水号

必需

businessAmount

number

业务金额（交易金额/手续费金额），单位：元

可选

>= 0.01<= 100000000000000000

businessModel

enum<string>

优惠商业模式

必需

枚举值:

businessSceneCode

string

业务场景码

必需

payAbilityCode

string

支付能力码

必需

payMethodCode

string

支付方式码

必需

cardIssuerCode

string

卡机构编号

可选

cardType

enum<string>

卡类型

可选

枚举值:

000C000D000UXXXX

count

integer <int64>

交易笔数

可选

countCycle

enum<string>

统计周期

必需

枚举值:

012

discountType

string

优惠方式

必需

0-固定金额；
1-手续费优惠折扣比例（万分比）；
2-本金优惠比例（万分比）；
Z-指定优惠金额；

discountValue

number

优惠值

必需

>= 0.01<= 99999999.99

startAmount

number

起始金额，单位：元

必需

>= 0.01<= 100000000000000000

endAmount

number

上限金额，单位：元

必需

>= 0.01<= 100000000000000000

marketingAmountMaxLimit

number

营销优惠金额最大上限, 单位元

可选

instalNum

string

分期期数

可选

正则匹配:

^[0-9]+$

mchtCode

string

内部商户号

必需

projectBank

string

合作模式

可选

quota

number

预算，单位：元

可选

>= 0.01<= 100000000000000000

registrationLevel

integer <int32>

优先级：数字越小优先级越高

必需

reason

string

驳回原因

可选

createBy

string

创建人

必需

示例

{
  "reqBody": {
    "accumulationAmount": 0.01,
    "accumulationAmountShareSwitch": "0",
    "accumulationType": "1",
    "activityId": 1000044,
    "beginDate": "2024-11-12 00:00:00",
    "endDate": "2024-12-12 23:59:59",
    "bizReqNo": "20241111113156",
    "businessAmount": 0.01,
    "businessModel": "1",
    "count": 2,
    "businessSceneCode": "Normal",
    "projectBank": "000000",
    "marketingAmountMaxLimit": 999999999,
    "countCycle": "0",
    "discountType": "1",
    "discountValue": 0.01,
    "startAmount": 0.1,
    "endAmount": 100,
    "quota": 10,
    "mchtCode": "531000023045074",
    "payAbilityCode": "WeChat,AliPay",
    "payMethodCode": "Default,WeChatScan,WeChatMiniApp,WeChatJsapi,WeChatNative,WeChatRefund,WeChatCancel,WeChatClosed,WeChatNativePack,AliPayScan,AliPayMiniApp,AliPayJsapi,AliPayNative,AliPayRefund,AliPayCancel,AliPayClosed",
    "registrationLevel": 1,
    "reason": "test",
    "createBy": "kxp",
    "cardType": "000D,000C",
    "actRuleList": [
      {
        "accumulationAmount": 0.01,
        "businessAmount": 0,
        "businessSceneCode": "Normal",
        "cardIssuerCode": "string",
        "cardType": "XXXX",
        "discountType": "1",
        "discountValue": 0.02,
        "endAmount": 10000,
        "quota": 1000,
        "instalNum": "2",
        "marketingAmountMaxLimit": 999999999,
        "payAbilityCode": "WeChat,AliPay",
        "payMethodCode": "AliPayJsapi,AliPayMiniApp,AliPayNative",
        "registrationLevel": 1,
        "startAmount": 1
      }
    ]
  },
  "reqHeader": {
    "transTime": "20241111113156",
    "reqId": "531000023045074"
  },
  "reqSign": "PzXZtc0tNaW4dkHxA/i14HAFlHhiJxFEm8TqXq2YBM0FEPS8mFrDADeo8QNp+u12ySzaREnlshLZdLuM8saaYUHUA7C67T06ZyfWa2qVGJKeibEMOSUaMNXtnuU0Y4mVSPKF/HzwaX9TIBW/BlbLyjEeqFXXzZU43qRCxYZK7AcDj39WRX/JUc9aX5cdLWEMOJw5dsvWqJF4t4zuKVN7HbSJHdyTbDDrekBjrXjGVFlJ1WgBjqsJgYn8+UrvMk63gHm3ND+27PDdR61tiKtxce5zmlTc37YTFWxFwG/EaZ2aCWQFD+d11F/A/KPrWIoYS1JqlxF+WXyIc4UViXRUWA=="
}

返回响应

🟢200OK

application/json

Body

rspBody

object

可选

checkId

integer <int64>

主键ID

可选

retCode

string

返回码

可选

retMsg

string

错误描述

可选

示例

请求报文

{
  "reqBody": {
    "accumulationAmount": 0.01,
    "accumulationAmountShareSwitch": "0",
    "accumulationType": "1",
    "activityId": 1000044,
    "beginDate": "2024-11-12 00:00:00",
    "endDate": "2024-12-12 23:59:59",
    "bizReqNo": "20241111113156",
    "businessAmount": 0.01,
    "businessModel": "1",
    "count": 2,
    "businessSceneCode": "Normal",
    "projectBank": "000000",
    "marketingAmountMaxLimit": 999999999,
    "countCycle": "0",
    "discountType": "1",
    "discountValue": 0.01,
    "startAmount": 0.1,
    "endAmount": 100,
    "quota": 10,
    "mchtCode": "531000023045074",
    "payAbilityCode": "WeChat,AliPay",
    "payMethodCode": "Default,WeChatScan,WeChatMiniApp,WeChatJsapi,WeChatNative,WeChatRefund,WeChatCancel,WeChatClosed,WeChatNativePack,AliPayScan,AliPayMiniApp,AliPayJsapi,AliPayNative,AliPayRefund,AliPayCancel,AliPayClosed",
    "registrationLevel": 1,
    "reason": "test",
    "createBy": "kxp",
    "cardType": "000D,000C",
    "actRuleList": [
      {
        "accumulationAmount": 0.01,
        "businessAmount": 0,
        "businessSceneCode": "Normal",
        "cardIssuerCode": "string",
        "cardType": "XXXX",
        "discountType": "1",
        "discountValue": 0.02,
        "endAmount": 10000,
        "quota": 1000,
        "instalNum": "2",
        "marketingAmountMaxLimit": 999999999,
        "payAbilityCode": "WeChat,AliPay",
        "payMethodCode": "AliPayJsapi,AliPayMiniApp,AliPayNative",
        "registrationLevel": 1,
        "startAmount": 1
      }
    ]
  },
  "reqHeader": {
    "transTime": "20241111113156",
    "reqId": "531000023045074"
  },
  "reqSign": "PzXZtc0tNaW4dkHxA/i14HAFlHhiJxFEm8TqXq2YBM0FEPS8mFrDADeo8QNp+u12ySzaREnlshLZdLuM8saaYUHUA7C67T06ZyfWa2qVGJKeibEMOSUaMNXtnuU0Y4mVSPKF/HzwaX9TIBW/BlbLyjEeqFXXzZU43qRCxYZK7AcDj39WRX/JUc9aX5cdLWEMOJw5dsvWqJF4t4zuKVN7HbSJHdyTbDDrekBjrXjGVFlJ1WgBjqsJgYn8+UrvMk63gHm3ND+27PDdR61tiKtxce5zmlTc37YTFWxFwG/EaZ2aCWQFD+d11F/A/KPrWIoYS1JqlxF+WXyIc4UViXRUWA=="
}


应答报文


{
    "rspBody": {
        "retCode": "000000",
        "checkId": 3185,
        "retMsg": "处理成功"
    },
    "rspHeader": {
        "easyPayCertificateId": "00000000",
        "rspCode": "000000",
        "rspInfo": "SUCCESS"
    },
    "rspSign": "CGvdx3PBt4LTvYpsSaFrQg9JwcO120arNx5liNleStc8OYl+OVhHI4JDx8Ujr85iDV0HJEyBn6FWl6CXrExMMaN5sg4jLQLtiUyYASV+42jYVjPyUHUhW/vaeN9VpOlUMN6Z1B3D6J7n8EiOsBj3Fi0Bh1dkqqrdxPKP3JHcBAfJtO6cn/ssk+RiPPpyqSquPd6StQRcxWt5Tk2PbrycE+k7P8kWnrDPxpkoZ4rp0WvcN0zk7rbsnuSwYbPIiIuadkaTXrLSdMgMzpR7or8wQ+61TGq8mevniGJp/SvVBhIMHhK3vVuCNp9J22BpvqpGgmtPq0G3Csnj6MFIwBl7CA=="
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found