公益开放平台-执行与反馈-接入指引

一、场景说明

通过接入腾讯公益开放平台的执行与反馈能力，公益机构可以将善款的执行过程和反馈进展同步到腾讯公益平台，实现从筹款 → 执行 → 反馈的完整闭环，让每一笔捐赠都有迹可循、有据可查，提升捐赠人的信任感和参与感。

1. 单元管理

单元是筹款与执行的最小单位，贯穿整个执行反馈流程。机构可以通过开放平台创建和管理单元，明确每笔善款的执行地点和受益对象。

• 前置单元：在筹款前由机构平台通过资助标准自动创建，用户捐款时直接匹配到对应单元，实现"捐款即定向"
• 后置单元：在执行阶段才创建，适用于筹款时尚未确定具体执行方案的场景，支持自动匹配流水或手动指定流水
• 单元信息绑定：确定受助对象后即可绑定执行地和受助人信息，可以发生在执行前的任意时间

2. 台账管理

当机构选择手动匹配流水时，可通过台账接口将指定的捐款订单绑定到后置单元，精确控制每笔善款的流向。

• 支持多次调用，逐批绑定订单
• 支持订单级别的金额拆分匹配
• 绑定完成后方可进行后续执行操作

3. 执行记录

机构完成实际执行动作后（如发放物资、拨付资金等），可通过执行接口将执行记录同步到公益平台，形成可追溯的执行台账。

• 一个单元可以有多次执行记录
• 每次执行记录包含执行金额、执行时间、执行凭证等信息
• 所有执行记录的总金额不能超过单元的筹款目标金额

4. 进展反馈

执行完成后，机构可以向捐赠人推送进展反馈，让捐赠人看到善款的实际使用情况。

• 执行进展推送：基于单元推送执行进展，单元下所有捐赠人都能收到反馈，支持多阶段节点数据（如：快递已揽收 → 运输中 → 已签收）
• 后续进展推送：在执行完成后，持续推送受助对象的后续进展（如感谢信、受助人近况等），让捐赠人持续感受到善意的回响

💡 执行与进展是两个完全独立的阶段。可以先完成一次或多次执行，之后在需要反馈给捐赠人时，再统一发进展。两者之间没有时间上的强关联，按业务实际节奏分别操作即可。

二、业务流程

通过上面的场景说明，可以了解执行与反馈能做什么。下面以不同的单元类型为例，说明整体如何串起来形成闭环体验。

2.1 前置单元标准流程

适用于在腾讯机构平台上通过资助标准自动创建了单元的场景。流程最为标准，适合已有明确资助计划的项目。

2.2 后置单元标准流程（自动匹配流水）

适用于创建后置单元时选择自动匹配流水的场景，流程最简，推荐优先使用。

2.3 后置单元手动匹配流程（不自动匹配流水）

适用于需要机构自行指定流水的场景，多一步手动匹配操作。

⚠️ 注意：这种方式需要确认手动匹配流水均匹配完，才能进行执行。

三、技术流程

3.1 前置单元执行反馈流程

适用于在腾讯机构平台上通过资助标准自动创建了单元的场景。

流程说明：

1. 阶段一 - 绑定单元信息：调用 为前置单元绑定信息 接口，指定 card_no 或不指定按规则自动绑定，返回绑定成功的 card_no。
2. 阶段二 - 单元状态回调查询：等待 单元状态变更通知 回调审核结果，或主动调用 查询单元状态 接口查询。
3. 阶段三 - 发起执行：审核通过后，调用 同步执行记录 接口，可多次调用，每次记录一件或一批具体事项。
4. 阶段四 - 发进展：在需要反馈捐赠人时，调用 执行进展推送 接口，单元下所有捐赠人将收到进展反馈。可选调用 后续进展推送 接口，推送受助对象后续进展（如感谢信等）。

⏳ 执行与进展无时间强关联，可间隔数天，按业务实际节奏分别操作。

3.2 后置单元执行反馈流程（自动匹配流水）

适用于创建后置单元时选择 自动匹配流水 的场景，流程最简，推荐优先使用。

流程说明：

1. 阶段一 - 创建单元：调用 创建后置单元 接口，设置 not_auto_match_flow = false，系统自动匹配流水，返回 card_no。
2. 阶段二 - 单元状态回调查询：等待 单元状态变更通知 回调审核结果，或主动调用 查询单元状态 接口查询。
3. 阶段三 - 发起执行：审核通过后，调用 同步执行记录 接口，可多次调用。
4. 阶段四 - 发进展：在需要反馈捐赠人时，调用 执行进展推送 接口。可选调用 后续进展推送 接口，推送受助对象后续进展。

⏳ 执行与进展无时间强关联，可间隔数天，按业务实际节奏分别操作。

3.3 后置单元执行反馈流程（手动匹配流水）

适用于需要接入方 自行指定流水 的场景，多一步手动匹配操作。

⚠️ 注意：这种方式需要确认手动匹配流水均匹配完，才能进行执行。

流程说明：

1. 阶段一 - 创建单元：调用 创建后置单元 接口，设置 not_auto_match_flow = true，返回 card_no（未关联流水）。
2. 阶段二 - 单元状态回调查询：等待 单元状态变更通知 回调审核结果，或主动调用 查询单元状态 接口查询。
3. 阶段三 - 手动匹配流水：调用 为后置单元绑定指定订单 接口，可多次调用直到匹配完成。
4. 阶段四 - 发起执行：流水匹配完成后，调用 同步执行记录 接口，可多次调用。
5. 阶段五 - 发进展：在需要反馈捐赠人时，调用 执行进展推送 接口。可选调用 后续进展推送 接口，推送受助对象后续进展。

⏳ 执行与进展无时间强关联，可间隔数天，按业务实际节奏分别操作。

四、注意事项

• 单元信息绑定后会进行机审或人审，需等待审核通过后才能进行执行操作
• 执行进展支持多阶段节点数据，更新进展时需要把当前所有节点都传过来（包含历史节点）
• 执行与进展无时间强关联，可间隔数天，按业务实际节奏分别操作