接入说明

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的json信息，如：{" reward_transcode":"trans_7890"}

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/BehaviorToDonate

请求参数：

• 请求示例

{
  "activity_no": "123456",
  "project_no": "224328",
  "third_uid": "user_001",
  "rule_content": "xxx",
  "reward_transcode": "trans_7890",
  "trans_time": "2025-08-01 12:00:00",
  "money": 100,
  "bid": "123456789"
}

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

其他错误码无需重试：

返回示例：

{
  "code": 0,
  "msg": "Success",
  "op_time": 1650812345,
  "trace_id": "1a2b3c4d5e6f7g8h1a2b3c4d5e6f7g8h",
  "data": {}
}

注： 1、捐赠金额会做校验，要求大于等于0.01元，小于等于1000元。

2、rule_content字段需要与企业平台创建的规则中的公益行为名称对应。

3、B2B查单接口

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

调用凭证： 应用签名

请求方式： POST（HTTPS）

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

请求参数：

注：bid+reward_transcode必填

• 请求示例

{
  "activity_no": "123456",
  "project_no": "224328",
  "third_uid": "user_001",
  "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",
    "money": 5000,
    "reward_transcode": "trans_7890",
    "donate_transcode": "donate_12345",
    "donate_status": 11
  }
}