外观
接入流程
约 523 字大约 1 分钟
接口对接流程
2026-10-19
在开始实现接口之前,先了解常规业务流程,再结合自身的发放方式实现对应接口。
业务时序
orderId 是我司订单号,也是幂等键。同一 orderId 重复发放只能对应一笔权益,两次都返回同一个 supplierOrderId。
同步与异步
同步:调用 权益发放 时,响应里的 status 就是终态。async 为 false。同步成功不要再发一次成功通知。
异步:发放接口先返回 PROCESSING,async 为 true。终态通过发放请求中的 notifyUrl 做 下发结果通知。
提示
- HTTP 非 200、超时、空响应时,我司会按同一
orderId重试,不当作明确失败。 code不为"0",或code为"0"且status为FAIL,我司视为本次发放失败,不再重试这张订单。
联调检查
- 同一
orderId发放两次,只产生一笔权益,订单号一致。 - 同步成功时,券码与响应一致。
- 异步受理后,成功、失败通知各走通一次。
- 核销通知中的时间和门店与请求一致;重复通知不报错。
- 查询能返回处理中、成功、失败、已核销。
- 若支持作废:成功后查询为
VOID;重复作废仍成功。 - 签名错误、时间戳超过 5 分钟时,回调被拒绝(
code不为"0")。