接入说明

1、前置准备，业务侧需要先申请应用，https://open.gongyi.qq.com/docs/guide/接入步骤.html

2、平台侧根据应用id分配支付bid

3、完成企业平台入驻，并成功创建活动，https://corp.gongyi.qq.com/#/register

4、如需接入发花，请参考小红花文档 小红花

概述

业务接入积分捐流程图

同步返回代扣结果，业务主动轮训订单状态，整体流程如下：

注：

1、有感发花流程参考小红花相关文档，文档链接: 小红花

2、有感发花调用接口PreTry预发花时，open_id填业务侧用户id、business_info填公益支付扣款返回的订单ID，如：{"donate_transcode":" donate_1234","reward_transcode":"reward_1234"}

调用接口

1、查询活动接口

使用场景： 业务在对接积分捐活动场景时，需要知道当前项目的活动相关信息，可以调用本接口来获取。

调用凭证： 应用签名

请求方式： POST（HTTPS）

请求地址： https://oapi.gongyi.qq.com/api/reward_donate_service/GetActivityInfo

请求参数：

注：同一个项目可能被绑定到多个活动上，所以该接口回包是一个数组，业务侧自行选择当前的活动。

• 请求示例

{
  "project_no": "224328"
}

返回参数：

返回示例：

{
  "code": 0,
  "msg": "Success",
  "op_time": 1650812345,
  "trace_id": "1a2b3c4d5e6f7g8h1a2b3c4d5e6f7g8h",
  "data": {
    "activity_no": "123",
    "activity_type": 2,
    "activity_name": "测试活动",
    "org_no": "110058",
    "activity_status": 2,
    "money": "500000",
    "merchant_no": "19680000001",
    "project_no_list": [
      "224328",
      "50000636"
    ],
    "xwj_rule": [
      {
        "content": "测试行为23333",
        "title": "测试行为335553444"
      },
      {
        "content": "测试行为345144",
        "title": "测试行为喂喂喂55"
      }
    ]
  }
}

2、B2B代扣接口

使用场景： 业务在对接积分捐活动场景时，积分扣除后需要发起活动的B2B扣款，调用本接口来完成扣款。

调用凭证： 应用签名

请求方式： POST（HTTPS）

请求地址： https://oapi.gongyi.qq.com/api/reward_donate_service/RewardToDonate

请求参数：

• 请求示例

{
  "activity_no": "123456",
  "project_no": "224328",
  "third_uid": "user_001",
  "reward": 1000,
  "reward_transcode": "trans_7890",
  "reward_time": "2025-08-01 12:00:00",
  "money": 5000,
  "bid": "12345"
}

返回参数：

注：donate_transcode真实长度为28个字符，后期可能变化，不建议对长度做强校验

以下错误码需要进行代扣重试：

其他错误码无需重试：

返回示例：

{
  "code": 0,
  "msg": "Success",
  "op_time": 1650812345,
  "trace_id": "1a2b3c4d5e6f7g8h1a2b3c4d5e6f7g8h",
  "data": {
    "activity_no": "123456",
    "project_no": "224328",
    "third_uid": "user_001",
    "reward": 1000,
    "money": 5000,
    "reward_transcode": "trans_7890",
    "donate_transcode": "donate_12345",
    "donate_status": 1
  }
}

3、B2B查单接口

使用场景： 业务在对接积分捐活动场景时，调用接口B2B扣款后，返回了订单状态为未成功支付，这是需要业务侧重新查单来继续校验该笔订单的状态。

调用凭证： 应用签名

请求方式： POST（HTTPS）

请求地址： https://oapi.gongyi.qq.com/api/reward_donate_service/RewardDonateQuery

请求参数：

注：donate_transcode与bid+reward_transcode二选一传入

• 请求示例

{
  "activity_no": "123456",
  "project_no": "224328",
  "third_uid": "user_001",
  "donate_transcode": "donate_12345",
  "bid": "12345",
  "reward_transcode": "trans_7890"
}

返回参数：

以下错误码需要进行重试：

其他错误码无需重试：

返回示例：

{
  "code": 0,
  "msg": "Success",
  "op_time": 1650812345,
  "trace_id": "1a2b3c4d5e6f7g8h1a2b3c4d5e6f7g8h",
  "data": {
    "activity_no": "123456",
    "project_no": "224328",
    "third_uid": "user_001",
    "reward": 1000,
    "money": 5000,
    "reward_transcode": "trans_7890",
    "donate_transcode": "donate_12345",
    "donate_status": 1
  }
}