退款推送
描述
收钱吧微信小店退款状态变更推送。
参数说明(JSON 格式)
| 参数 | 参数名称 | 类型 | 描述 |
|---|---|---|---|
| eventId | 推送事件ID | bigint | 全局唯一 |
| timestamp | 推送时间戳 | bigint | 当前时间毫秒值 |
| nonce | 随机字串 | String | 随机字串,用于签名 |
| content | 订单数据 | String | JSON 字符串,详见 Content 字段格式 |
| signature | 报文签名 | String | 详见公共推送验签 |
content 示例
{
"eventId": null,
"ticketSn": "2025082920061704957",
"ticketSignature": "JI96180op1nOy1uFGLzp",
"orderSn": "7273664071206046",
"orderSignature": "a6PyyR3gtXr1vh2PvWTA",
"seller": {"merchantSn": "1680007249469"},
"createdAt": 1756469178029,
"sourceState": 0,
"targetState": 5,
"bizParty": "optimus",
"tradeApp": "24",
"tags": ["咸子萱", "高一2班", "13922721367", "白云汇"],
"amount": 0,
"applyAmount": 70000,
"ticketCTime": 1756469178000,
"requestId": "175646917704148028",
"requestSource": null,
"bizExtended": null
}
Content 字段格式(JSON 字串)
| 参数 | 参数名称 | 类型 | 描述 |
|---|---|---|---|
| ticketSn | 售后单号 | String | 全局唯一 |
| orderSn | 订单号 | String | |
| sourceState | 原状态 | Integer | |
| targetState | 目标状态 | Integer | 20 退款完成 30 退款失败 |
| amount | 下单金额 | Long | |
| applyAmount | 申请金额 | Long | |
| requestId | 请求号 | String | |
| requestSource | 来源 | String | EXTERN |
| item | 退款的商品信息 | Map\ |
传入的商品信息 |
| externExtend | 外部拓展参数 | Map\ |
|
| billSnList | 退款的账单 | List\ |
指定账单退款 |
| orderBillSnList | 原订单的账单 | List\ |
原订单支付的账单 |
item.items
| 参数 | 参数名称 | 类型 | 是否必传 | 描述 |
|---|---|---|---|---|
| spuId | spu | String | Y | |
| skuId | sku | String | Y | |
| title | 标题 | String | Y | |
| quantity | 数量 | String | Y | |
| type | 退款类型 | Byte | Y | 0 正常商品 1 自定义商品 |
item.type
| 参数 | 参数名称 | 类型 | 是否必传 | 描述 |
|---|---|---|---|---|
| type | 退款类型 | Byte | N | 1 商品 2 金额 |
验签方式
见 公共推送验签。