营销奖励核销回调

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 错误码

附录 - 错误码

© 2026 Shenzhen ChinaRoad Technology Co., Ltd. © All Rights Reserved            UPDATED 2026/09/11 20:04:16

results matching ""

    No results matching ""