二轮充电桩行业活动回传（物料&交易）商户对接接口

接口地址

完整地址 = 域名 + 固定路径 /mch-service/api；业务接口由请求参数 method 区分，本接口固定 method = activity_rebate_transactions。

1. 接口调用说明

1.1 开发指引 · 整体说明

公共请求参数（表单字段）

签名与应答验签

请求签名（商户 → 宝付）

1. 取 bizContent 的 JSON 原文（与实际上送的完全一致，勿重新格式化）。
2. 用商户 API 证书私钥按 signType 指定算法签名（RSA = SHA256WithRSA / SM2），结果 Base64 放入 signStr。

应答验签（宝付 → 商户）：应答返回 signStr，商户用宝付证书公钥对 dataContent 的 JSON 原文验签。

统一应答信封

应答示例

成功（信封）

{
  "returnCode": "OK",
  "returnMsg": "OK",
  "dataContent": "{\"resultCode\":\"SUCCESS\",\"orderNo\":\"CR20260918A0000123\",\"activityType\":\"CHARGE_REBATE\",\"channel\":\"WX\",\"outTradeNo\":\"CR20260918000001\",\"policyId\":\"1135\"}",
  "signStr": "XXXXXX"
}

应答示例

失败（验签 / 商户终端 / 时间戳等进线拦截）

{
  "returnCode": "FAIL",
  "returnMsg": "验签错误",
  "dataContent": "{}",
  "signStr": "XXXXXX"
}

公共错误码（returnCode=FAIL）

1.2 活动回传（物料&交易）

运营商在渠道行业返佣活动下完成一笔交易后，将「交易 + 收款物料 URL」关联数据回传，渠道据此计算返佣。

幂等：以进线 merId（宝付商户号）+ bizContent.out_trade_no 作为唯一键。成功记录重复上送且内容一致 → 返回首次结果；失败记录可重入（同单号同内容会重新转调渠道）；内容不一致 → 返回业务错误，不覆盖首次记录。

重试：宝付不做服务端自动重试。上送失败后，请使用相同 out_trade_no 重试；请勿更换新的订单号重试，否则会产生重复回传。

物料前置条件（微信）：渠道侧会校验「收款链接已登记物料 + 该物料已报名对应政策」，未满足时受理会失败。请先完成微信侧的物料登记与政策报名。

接口说明

请求方式：POST /mch-service/api

请求域名：见「接口地址」

请求参数：表单公共参数 + method = activity_rebate_transactions；业务字段放 bizContent（JSON 字符串）

请求参数

表单公共参数

见「开发指引 · 整体说明」中的公共请求参数表；本接口 method 固定为 activity_rebate_transactions。

bizContent 结构（公共字段 + 业务 JSON）

校验口径：宝付只校验公共字段（activity_type / channel / out_trade_no 必填与长度）。biz_data 内字段不做拦截校验，由渠道侧校验并原样回传错误。

分册：充电返佣（activity_type = CHARGE_REBATE，channel = WX）

适用政策（biz_data.policy_id）：1135 四轮充电 / 1085 智能柜 / 1138 二轮充电。

必填含义：上表「必填」为对接提醒——宝付不对 biz_data 做拦截校验（含必填、长度与范围）。缺字段 / 超长 / 越界会原样透传给微信，由微信返回错误（如 400 INVALID_REQUEST），宝付将渠道错误原样回传。请务必按上表上送必填字段。

未声明字段：biz_data 中分册以外的字段同样原样透传并落库，不拦截、不丢弃。

请求示例

bizContent 为下方 JSON 的字符串形式（签名时使用该原文）：

{
  "activity_type": "CHARGE_REBATE",
  "channel": "WX",
  "out_trade_no": "CR20260918000001",
  "biz_data": {
    "trade_mchid": "1507871311",
    "policy_id": "1135",
    "code_url": "https://qr.weixin.qq.com/xxx",
    "device_id": "DEV-0001",
    "station_name": "XX充电站（人民广场店）",
    "device_longitude": "121.473701",
    "device_latitude": "31.230416"
  }
}

表单上送示意（字段值需 URL Encode；signStr 为对 bizContent 原文的签名）：

merId=100000001
&terId=10000001
&method=activity_rebate_transactions
&charset=UTF-8
&version=1.0
&format=json
&timestamp=20260918143000
&signType=RSA
&signSn=1
&ncrptnSn=1
&dgtlEnvlp=
&bizContent={"activity_type":"CHARGE_REBATE","channel":"WX","out_trade_no":"CR20260918000001","biz_data":{"trade_mchid":"1507871311","policy_id":"1135","code_url":"https://qr.weixin.qq.com/xxx","device_id":"DEV-0001","station_name":"XX充电站（人民广场店）","device_longitude":"121.473701","device_latitude":"31.230416"}}
&signStr=XXXXXX

应答参数

dataContent 内的 JSON 字段：

应答示例

成功（dataContent 解析后）

{
  "resultCode": "SUCCESS",
  "orderNo": "CR20260918A0000123",
  "activityType": "CHARGE_REBATE",
  "channel": "WX",
  "outTradeNo": "CR20260918000001",
  "policyId": "1135"
}

应答示例

业务失败（returnCode=OK，dataContent 解析后）

{
  "resultCode": "FAIL",
  "errCode": "REBATE_CHANNEL_BIZ_FAIL",
  "errMsg": "渠道侧受理失败：政策 ID 非法",
  "orderNo": "CR20260918A0000124",
  "activityType": "CHARGE_REBATE",
  "channel": "WX",
  "outTradeNo": "CR20260918000002",
  "policyId": "9999",
  "respCode": "INVALID_REQUEST",
  "respMsg": "政策 ID 非法"
}

错误码

业务错误码（returnCode=OK + dataContent.errCode）

说明：请求被成功受理后，业务成败一律通过 returnCode=OK + dataContent.resultCode 表达；仅当请求本身不合法（验签、商户/终端、时间戳、系统异常）时 returnCode=FAIL。

2. 异步通知（notify_url）

不适用：本接口为同步受理，宝付不向商户发起异步通知。受理结果以同步应答为准。

3. 数据字典

3.1 activity_type

3.2 channel

3.3 policy_id（属 biz_data，仅充电返佣）

3.4 resultCode