券状态推送
描述
收钱吧微信小店券状态变更推送。
参数说明(JSON 格式)
| 参数 | 参数名称 | 类型 | 描述 |
|---|---|---|---|
| eventId | 推送事件ID | bigint | 全局唯一 |
| timestamp | 推送时间戳 | bigint | 当前时间毫秒值 |
| nonce | 随机字串 | String | 随机字串,用于签名 |
| content | 订单数据 | String | JSON 字符串,详见 Content 字段格式 |
| signature | 报文签名 | String | 详见公共推送验签 |
content 示例
{
"operation": 0,
"orderSn": "",
"mallSn": "",
"merchantSn": "",
"storeId": "",
"voucherList": [
{
"voucherNo": {},
"type": 0,
"status": 0,
"voucherName": "",
"operationTime": "",
"item": {"spuId": 0, "skuId": 0, "title": "", "img": ""},
"qrCodeUrl": 1,
"oriAmount": "",
"receivedAmount": "",
"redeemInfo": {
"redeemSource": "",
"redeemAppId": "",
"redeemClientSn": "",
"redeemExternalOrderSn": "",
"operatorMerchantId": ""
}
}
]
}
Content 字段格式(JSON 字串)
| 参数 | 参数名称 | 类型 |
|---|---|---|
| orderSn | 订单编号 | String |
| mallSn | 商城Sn | String |
| merchantSn | 商户Sn | String |
| storeId | 门店id | String |
| voucherList | 券 | List\ |
voucherList 字段格式
| 参数 | 参数名称 | 类型 | 描述 | 示例 |
|---|---|---|---|---|
| voucherNo | 券号 | String | ||
| type | String | |||
| targetState | 券状态 | Byte | 0 未核销 1 已核销 2 未核销退款中 3 已核销退款中 4 未核销退款完成 5 已核销退款完成 6 已失效 | |
| sourceState | 券原状态 | Byte | ||
| voucherName | 券名称 | String | ||
| operationTime | 操作时间 | String | yyyy-MM-dd HH:mm:ss | |
| item | 商品信息 | Object | ||
| qrCodeUrl | 券二维码地址 | String | ||
| qrCodeContent | 券二维码内容 | String | ||
| oriAmount | 原金额 | Long | ||
| receivedAmount | 实收金额 | Long | ||
| redeemInfo | 核销信息 | Object |
item 字段格式
| 参数 | 参数名称 | 类型 |
|---|---|---|
| spuId | Long | |
| skuId | Long | |
| title | 商品标题 | String |
| img | 商品图片地址 | String |
redeemInfo 字段格式(已核销时会有这部分)
| 参数 | 参数名称 | 类型 | 描述 | 示例 |
|---|---|---|---|---|
| redeemSource | 操作来源 | String | EXTERN | |
| redeemAppId | 操作appId | String | ||
| redeemClientSn | 客户端编码 | String | ||
| redeemExternalOrderSn | 外部编码 | String | {appId} + 请求号 | |
| operatorMerchantId | 操作商户 | String | userId |
验签方式
见 公共推送验签。