外观
接入须知
约 478 字大约 1 分钟
指南快速开始
2026-10-19
本文是供应商需要实现的接口协议。我司按本文调用贵司,并接收贵司的发放结果与核销通知。
在接入之前请先阅读以下内容。
能力范围
必须实现:权益发放、订单查询。按发放方式和业务能力再实现:
| 能力 | 是否必须 | 说明 |
|---|---|---|
| 权益发放 | 必须 | 我司下单时调用 |
| 订单查询 | 必须 | 我司补查处理中、未核销订单 |
| 下发结果通知 | 异步发放必须 | 同步发放不要再通知一次成功 |
| 核销结果通知 | 有核销时必须 | 与下发通知同一地址,用 status 区分 |
| 权益作废 | 可选 | 不支持就不要提供该接口 |
有不限于如下几点:
一、请妥善保管对接过程中的 appId、appSecret。
二、orderId 是我司订单号,也是幂等键。同一 orderId 重复发放只能对应一笔权益。
三、请使用发放请求中的 notifyUrl 回调,不要写死环境地址。
解决问题
文档利用
提示
- 请先参考文档,大部分问题都能通过本文档来解决,减少双方做重复性工作。
- 如文档不能解决疑问,可以在对接群中做
技术咨询。 - 文档有误/不足,还望指出,帮助我们进一步改进/完善文档。
技术咨询
咨询问题时尽量提供问题的详细信息,以便更好/更快地查询/定位问题,提升双方效率。
orderId/supplierOrderId/productCode,具体时间。- 说明具体的场景及现象,是
发放失败、通知失败还是查询结果不一致。 参数(调用的原始参数)/结果(返回的原始结果),提供报文。