营销奖励核销回调
1 接口说明
该接口为回调接口,由合作方实现,P云主动调用,用于接收用户用券(核销)通知。
bonus_id 与提交奖励事件参与申请应答消息 bonus 节点的 id 属性具有关联性,接口实现方匹配每条奖励记录进行核销结果处理。
2 请求方式
HTTP POST,通过 URL 传参或 form 表单传参。
- 合作方收到请求后应先验签再处理业务,规则见回调通知验签;
- 处理成功请返回
code = 1001(异常返回1500),否则 P云会重复通知,需按业务单号做幂等处理。
3 请求参数
| 字段 | 类型 | 必须 | 说明 |
|---|---|---|---|
| user_code | string | Y | 用户唯一标识 |
| mobile | string | N | 手机号 |
| status | short | Y | 状态,1已核销 |
| bonus_id | string | Y | 奖励优惠券ID |
| value | int32 | Y | 核销金额,单位分 |
| apply_time | timestamp | Y | 核销时间 |
4 响应参数
| 字段 | 类型 | 必须 | 说明 |
|---|---|---|---|
| code | string | Y | 业务处理状态码, 1001-处理成功, 1500-处理异常 |
| message | string | N | 业务处理状态说明 |
| hint | string | N | 提示说明 |
5 错误码
见附录 - 错误码。