易企通2.0
  1. 13.1 手续费营销
易企通2.0
  • 1.总体介绍
    • 1.1 阅读人员
    • 1.2 名词解释
    • 1.3 业务接入指引
    • 1.4 版本说明
    • 1.5 接口调试工具说明
  • 2.接口规范
    • 2.1 接口格式定义
    • 2.2 加签验签说明
    • 2.3 参数说明
  • 3.商户进件类接口
    • 3.1 收单商户信息
      • 3.1.1 图片上传接口
      • 3.1.2 商户信息录入
      • 3.1.3 商户信息变更
      • 3.1.4 申请单状态查询
      • 3.1.5 商户详情信息查询
      • 3.1.6 商户审核异步通知
      • 3.1.7 商户注销申请
    • 3.2 非收单会员信息
      • 3.2.1 非收单会员信息录入
      • 3.2.2 非收单会员信息查询
      • 3.2.3 非收单会员信息变更
      • 3.2.4 分账关系绑定
      • 3.2.5 分账关系解绑
      • 3.2.6 查询分账关系
    • 3.3 终端管理
      • 3.3.1 机具入库
      • 3.3.2 终端机具参数查询
      • 3.3.3 物料查询
      • 3.3.4 查询授权码
      • 3.3.5 重置授权码
      • 3.3.6 商户终端状态管理
      • 3.3.7 终端绑定/解绑申请
      • 3.3.8 终端换机申请
      • 3.3.9 辅助终端设备信息校验
    • 3.4 微信支付宝配置类
      • 3.4.1 微信支付宝商户入驻
      • 3.4.2 微信支付宝认证申请
      • 3.4.3 微信支付宝认证申请状态查询
      • 3.4.4 微信支付宝认证申请结果查询
      • 3.4.5 微信支付宝子商户信息查询
      • 3.4.6 微信商户新增APPID
      • 3.4.7 微信商户新增支付授权目录
      • 3.4.8 微信商户开发配置查询
      • 3.4.9 微信支付宝商户信息修改
    • 3.5 电子协议
      • 3.5.1 企业开户
      • 3.5.2 个人开户
      • 3.5.3 创建合同
      • 3.5.4 发送验证码
      • 3.5.5 签署合同
      • 3.5.6 查询合同
      • 3.5.7 下载合同
      • 3.5.8 增加印章
      • 3.5.9 查询印章
      • 3.5.10 修改印章
      • 3.5.11 删除印章
    • 3.6 商户交易限额管理
      • 3.6.1 新增限额
      • 3.6.2 查询限额
      • 3.6.3 修改限额
    • 3.7 渠道报备查询
      • 3.7.1 商户报备查询
      • 3.7.2 终端报备查询
  • 4.条码类交易接口
    • 4.1 支付
      • 4.1.1 付款码支付
      • 4.1.2 JSAPI支付
      • 4.1.3 主扫支付
      • 4.1.4 云闪付APP支付
      • 4.1.5 交易查询
      • 4.1.6 交易查询(返费率)
      • 4.1.7 交易关闭
      • 4.1.8 交易结果通知
      • 4.1.9 银联无感支付签约
      • 4.1.10 银联无感支付解约
    • 4.2 退款
      • 4.2.1 实时退款
      • 4.2.2 极速退款
      • 4.2.3 退款查询
    • 4.3 获取授权/UID
      • 4.3.1 获取支付宝UserId(定制接口)
      • 4.3.2 获取微信openId(定制接口)
      • 4.3.3 获取银联用户标识
  • 5.订单分账类接口
    • 5.1 请求分账
    • 5.2 分账查询
    • 5.3 分账回退
  • 7.延时确认类接口
    • 7.1 延迟交易确认
    • 7.2 延时交易确认查询
    • 7.3 延时交易确认退款
    • 7.4 延时交易确认退款查询
    • 7.5 延迟确认后台通知
    • 7.6 延迟确认交易极速退款
  • 8.账户类接口
    • 8.1 转账
    • 8.2 提现(暂不使用)
    • 8.3 账户余额查询
    • 8.4 账户明细查询
    • 8.5 转账/提现查询
    • 8.6 提现后台通知
  • 9.其他辅助类接口
    • 9.1 单笔交易手续费查询
    • 9.2 单笔交易结算查询
    • 9.3 结算结果通知(暂不能使用)
  • 10.对账文件
  • 11.信用付(先享后付)
    • 11.1 微信支付分
      • 需确认模式
        • 11.1.1 创建支付分订单
        • 11.1.2 查询支付分订单
        • 11.1.3 取消支付分订单
        • 11.1.4 确认订单回调通知
        • 11.1.5 完成支付分订单
        • 11.1.6 登记扣款信息
        • 11.1.7 查询扣款信息
        • 11.1.8 微信分代扣
        • 11.1.9 主动支付成功通知
        • 11.1.10 关闭支付分订单
    • 11.2 支付宝芝麻分
  • 12.预付卡支付
    • 12.1 预付卡余额支付
  • 13.营销类接口
    • 13.1 手续费营销
      • 13.1.1 手续费营销商户报名
        POST
      • 13.1.2 手续费营销商户活动查询
        POST
      • 13.1.3 手续费营销商户报名终止
        POST
      • 13.1.4 手续费营销商户报名查询
        POST
    • 13.2 微信支付宝营销活动
      • 13.2.1 渠道图片上传
      • 13.2.2 渠道营销活动新增接口
      • 13.2.3 渠道营销活动查询接口
      • 13.2.4 渠道营销活动更新接口
    • 13.3 银联营销活动
      • 13.3.1 银联营销查询
      • 13.3.2 银联营销余额查询
    • 13.4 指令营销类
      • 13.4.1 营销活动变更
      • 13.4.2 营销活动查询接口
  • 14.QS优化
    • 14.1 特殊费用配置新增
    • 14.2 特殊费用配置更新
    • 14.3 特殊费用配置查询
    • 14..4 指令结算
    • 14.5 指令结算查询
  • F.附录
    • F.1 返回码说明
    • F.2 BankType微信银行类型
    • F.3 fund_channel支付宝渠道
    • F.4 acctClass云闪付账户类型
    • F.5 CertType证件类型
    • F.6 payType交易方式
    • F.7 terminalInfo终端信息说明
    • F.8 acctType账户类型
    • F.9 cardType付款卡类型
    • F.10 cardIssuerCode卡机构编码
    • F.11 云闪付云微笔笔支付小程序说明
    • F.12 transType交易类型
    • F.13 dgtlEnvlp 参数说明(付款)
    • F.14 商户类型所需图片
    • F.15 JSAPI预下单后 微信/支付宝调起支付步骤
    • F.16 扫码支付微信支付开户意愿确认、支付宝商家认证流程
    • F.17 银联二维码云微支付小程序说明
    • F.18 银联无感支付云微小程序调用说明
    • F.19 businessCode 字段传值
    • F.20 商户调起微信分小程序说明
    • F.21 银联二维码qrCode说明
    • F.22 白条 orderInfo/goodsInfo 参数附加说明
    • F.24 非收单会员sceneFunctionList
  • FAQ
    • 付款码支付验密规则说明
    • 微信主扫方案
    • 常见问题
  • 易企通1.0防腐层接口
    • 聚合支付
      • 标准-付款码支付
      • 主扫
      • 标准-JSAPI支付
      • 银联JS-获取用户标识
      • 银联JS-获取临时用户授权
      • 银联云闪付app支付(原云闪付控件支付)
      • 获取微信openid
    • 交易
      • 分账
        • 请求分账
        • 分账撤销
        • 分账接收方请求绑定
        • 分账绑定关系查询
        • 分账请求结果查询
        • 分账子单详情结果查询
        • 分账回退
      • 退款
        • 实时退款
        • 退款查询
        • 极速退款-账户代扣(防腐层新)
        • 交易已退已分账头寸查询
      • 担保
        • 担保申请
        • 担保撤销
        • 担保确认
        • 担保查询
      • 清算
        • 秒到交易查询(老-防腐层)
        • D1和T1交易结算查询
        • 商户余额查询
      • 标准-交易单笔查询
      • 标准-交易支付成功通知
      • 标准-关闭订单
  • 回收站
    • 防腐层
      • 微收单优化
        • 代付API
          • 代付处理
        • health-check-controller
          • check
          • check
          • check
          • check
          • check
          • check
          • check
          • check
        • 清算相关查询API
          • 秒到交易查询
          • 秒到交易查询(老)
          • 无交易退款
        • 通知API(内部)
          • 标准-代付后台通知
          • 交易前台通知
          • 交易前台通知
          • 交易前台通知
          • 交易前台通知
          • 交易前台通知
          • 交易前台通知
          • 交易前台通知
          • 交易前台通知
          • 退款后台通知
        • 机构信息API
          • 机构信息新增
          • 机构信息查询
        • 退货API
          • 极速退货-账户代扣
        • spring-bean-test-controller
          • getAllServiceBeans
          • getAllServiceBeans
          • getAllServiceBeans
          • getAllServiceBeans
          • getAllServiceBeans
          • getAllServiceBeans
          • getAllServiceBeans
          • getAllServiceBeans
          • getServiceMethodMetadata
          • getServiceMethodMetadata
          • getServiceMethodMetadata
          • getServiceMethodMetadata
          • getServiceMethodMetadata
          • getServiceMethodMetadata
          • getServiceMethodMetadata
          • getServiceMethodMetadata
          • testSpringServiceMethod
          • testSpringServiceMethod
          • testSpringServiceMethod
          • testSpringServiceMethod
          • testSpringServiceMethod
          • testSpringServiceMethod
          • testSpringServiceMethod
          • testSpringServiceMethod
        • 交易API
          • wxAppId可由前端传过来的-微信jsapi支付
    • 6.付款类接口
      • 6.1 付款
      • 6.2 付款查询
      • 6.3 付款(专)
      • 6.4 付款查询(专)
      • 6.5 代付后台通知
    • 通知接口
      • 消费通知接口
      • 分账通知接口
    • 会员商户操作审核
    • 商户协议签约
    • 开户
    • 商户开户
    • 3.1.2 商户信息录入(已废)
    • 3.1.3 商户信息变更(已废)
    • 3.1.4 修改商户经办人手机号
    • 3.1.5 会员商户状态管理
    • 3.3.2 终端机具号更新
    • 3.7.3 商户网联报备申请
    • 3.7.4 新增渠道商户路由
    • 3.8.2 渠道营销活动元数据选项查询
    • 4.3.4 获取支付宝授权
    • 4.3.5 获取微信授权
    • 4.8.6 获取银联授权
    • 8.7 提现(专用)
    • 9.2 商户费率查询
    • 11.1.9 主动支付预下单通知
    • 11.1.4 确认订单回调通知2
    • 11.1.9 主动支付结果通知2
    • 商户终端密钥重置
  1. 13.1 手续费营销

13.1.1 手续费营销商户报名

易企通2.0联调环境 (对外)
https://d-phoenix-gap.easypay.com.cn:24443/yqt
易企通2.0联调环境 (对外)
https://d-phoenix-gap.easypay.com.cn:24443/yqt
POST
https://d-phoenix-gap.easypay.com.cn:24443/yqt
/merchant/marketing/add
营销类接口API
1、通过接口为商户报名

请求参数

Body 参数application/json
reqBody
object 
请求体
必需
accumulationAmount
number 
额度,单位:元
可选
>= 0.01<= 100000000000000000
accumulationAmountShareSwitch
string 
是否共享额度
必需
优惠额度(累计金额)是否共享开关,0:否;1:是;
accumulationType
enum<string> 
额度累计类型
必需
枚举值:
12
actRuleList
array[object (ActRegSubRuleVO) {14}] 
子规则信息
必需
activityId
number 
活动id
可选
agentMchtCode
string 
拓展商户编号
可选
这是扩展方编号
beginDate
string <date-time>
活动开始时间
必需
endDate
string <date-time>
活动结束时间
必需
billingCycle
string 
结算周期
可选
bizReqNo
string 
业务请求流水号
必需
businessAmount
number 
可选
业务金额(交易金额/手续费金额),单位:元
>= 0.01<= 100000000000000000
businessModel
enum<string> 
优惠商业模式
必需
枚举值:
12
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
上一页
12.1 预付卡余额支付
下一页
13.1.2 手续费营销商户活动查询
Built with