营销活动领取回调
1 接口说明
该接口为回调接口，由合作方实现，P云主动调用，用于通知用户领券结果。
2 请求方式
HTTP POST，通过 URL 传参或 form 表单传参。
- 合作方收到请求后应先验签再处理业务，规则见回调通知验签；
- 处理成功请返回
code = 1001（异常返回1500），否则 P云会重复通知，需按业务单号做幂等处理。
3 请求参数
| 字段 | 类型 | 必须 | 说明 |
|---|---|---|---|
| user_code | string | Y | 用户唯一标识 |
| mobile | string | N | 手机号 |
| status | short | Y | 状态，0未发放，1发放中，2已发放，-1已失效 |
| bonus_id | string | Y | 奖励优惠券ID |
| value | int32 | Y | 奖励面额，单位分 |
| effect_time | timestamp | Y | 生效时间 |
| expire_time | timestamp | Y | 失效时间 |
4 响应参数
| 字段 | 类型 | 必须 | 说明 |
|---|---|---|---|
| code | string | Y | 业务处理状态码, 1001-处理成功, 1500-处理异常 |
| message | string | N | 业务处理状态说明 |
| hint | string | N | 提示说明 |
5 错误码
见附录 - 错误码。