订单支付通知 #
用户支付订单之后,会通过WebHook方式通知供应商。(供应商订阅消息,接收消息推送)
最佳实践
供应商应该依据通知中的订单号调用 获取订单详情接口获取订单详情。
消息类型 #
| 消息类型(code) | 说明 |
|---|---|
| ORDER_PAID | 订单支付 |
请求数据(body) #
{
"code": "ORDER_PAID",
"content": "/yD+pxR9t5iysKH9JDF1oHHCo3I6iysrMpP6NDqFACirQx9joSalPxUpkLjIgdIUrj3ahEKjuVpPMsZDp799qHUFimlJfoAsyxMSBh3ZlORXFrreT2KT1Nalu62/m37nHaoQTo+UU+WyJWKRkPxd+0H+Fag7fTdG9Hsj+bfdkKTkqmDsaN580f2jFDGmQsLKWiGsPjVr7lGOTWnOJ3XtCFVBpBr6bdP0brX9dY92izRS5/9zj8Ju0Tya5i0Bam8Icbu9khO4qYINEgW9gCt5qCeE+KCR9WOsY4qm2DcQ5HBVmnr+NRMi+HfWU7mb8kVkbrX9dY92izRS5/9zj8Ju0ThCQ+gMxTW3xpYw48JtEykVKZC4yIHSFK492oRCo7laTzLGQ6e/fagcvJAiW7LI+TEEhDK6fU1q3r4X4Jy5fJ4xHg2awgAQUU3xwwyDUX/OVIjIYUmmMXXvL2Rl5EBMXQHQ5lvm58UnotqOVgFcpX8pGkffGGHrc7Dn48UxfuG0jSMygSSCc7EzWoNxJQtA6F/60XG2jcvYdtachCb8vAu9WhkFay5EhvdeU/gIfdQmemWKOG2jfHttkqBfVXSAPbFlkpoI48+4+N1xh1HMx6yo+XHFOgIKSHf7IEutSg03y7FQg+AalUbCt4OdQT3WYUevmKFlWZRqB8yvr7tSQEEm5Y0hyQLYiNe98G7LueHbvWxRYNUxljhnkM+FwnvR81In3CKxUOpER5+ASeDnWERq8hKdrq/C+4eYX9zIaiQELyB7oAughcZLqSH2N7GbIPR7I/m33ZCkIC80BLc9l05fUltN+Jtzq6x1/W15PCFJMu2/blj1IBbpimVySvsA1LfbYa0hK7nv2yw8R/WPeYsuwm6JzVCzgCDL7oNwRFo0DLx9NqTdAZNQ+BQjAZbtfzFfm2ZQZz8B+xjRQuG7oY9lxpFIARKye5aZtVneXBLDukz84lESfsLtYxztP8N2qbjF92BfdNvVKwCQxwCjLpBODYuheuNLklgYnxUkeRgIavGkSAYwqtQrI5Ic+N0I2k0RhmYTygCxsgwaMHVaxk+SAs3Je2P1IaQ9JjQzC3s7TkDR1qa7hf+3jbxxlEIQUZlhLrdPtxy4iLM/EnaDT77vqsdWN7ex2FnwZIg304/Tm/O9uH2ENifv7ovC3TcrqSR5ZWdcwjUX/4ehEE1dcAGBiO4BBbBJP4MlTT7mT15V/wf+p8x6KS/W9gveKe7zjrLijpe5pDV1RzVG8jktuRiDPtnNbO5SIjuCAH4dQ8RPr8PhU14jwiapF/Dwe4dFHoJn3T0TwWiMFnw+M+tcXSJnnYdN6tXKJej8euVRCz6ryiUY7LXR0EL9fcaZZTsH1Bw+TXWsfwxJs5+DJ1KFms40O/hGwpqHu+poeVuL4ri7MlbuwaI0NSaOTNrcqKYzUKJTgW4IQAzFyeENp0Wwm5p1K6bosVLhm651Vt+eMGl1GHkasUcvx3TxyqzkxN0SH9Y4G6dYaQTtapUQkhNV/XRZEq7GqGl52O1pjaPTTdQBboKFd09JIVv62s10VoyyBlc8qrARa/S1D6DoRCp9PhOh7jZ7rRn7G3NQOnpt4O3AuMX3YF9029UVQyUoJfGUoaWIG1bL4m6srmSePBegSck7UMNuuk2TmMEQhxurAoM+KYrTWROLZcfTA8GHnW/Ete1DCZ5MirrhthLjybFzMgPXsNeTZfo0N2RaTlu67e+6BYUbOVQVEu4bEWHnNCxs1sjYQIo++bL+JmruMusM60VBEimWiObTGLY9yiyNytwRBzynEhm6oLwXllnIpKObA8uR96RMnWIgDcB2d8qsKycozStcO6OvxT90THPjQu1KgKJWJL6BSQbbNkIVOp0MoUOd72Dj49o1jJz1CoHVISk58r732Ok6mT7XGubbE5A8Uk3O6ODaxJKgezkiNuJPyIJ74A3LGZ0v14t5kQybQeEg4CCeBu88SbkgOEY9vqD/1OiTk40Qh5zvFrzzjy9ce35cxzfBlJFllaNDtS2U7s4=",
"request_uuid": "5d8f7430-e5ad-4bdd-80a3-e93603e1ebe1",
"notice_at": "2024-05-27T23:52:20+08:00"
}
订单状态(state)说明:
#
| 状态 | 类型 | 说明 |
|---|---|---|
| 1 | int | 待付款 |
| 12 | int | 付款中(唤起支付) |
| 20 | int | 待发货(已付款) |
| 22 | int | 部分发货 |
| 25 | int | 待收货(全部发货) |
| 30 | int | 已收货(买家确认收货) |
| 40 | int | 交易完成 |
| -1 | int | 交易关闭(超时未支付) |
| -2 | int | 交易取消(买家取消,卖家取消) |
业务数据(body.content)解密后 #
| 参数名 | 类型 | 参数路径 | 是否必填 | 说明 |
|---|---|---|---|---|
| trade_no | string | 是 | 订单号 | |
| created_at | string | 是 | 创建时间 | |
| updated_at | string | 是 | 更新时间 | |
| state | int | 是 | 订单状态 | |
| total_price | float | 是 | 总价(含运费) | |
| total_freight | float | 是 | 总运费 | |
| cancel_reason | string | 否 | 取消原因 | |
| remark | string | 否 | 备注 | |
| paid_at | string | 否 | 付款时间 | |
| total | int | 是 | 订单商品总数 | |
| province | string | 是 | 收货人省份 | |
| city | string | 是 | 收货人城市 | |
| district | string | 是 | 收货人区县 | |
| address | string | 是 | 收货详细地址 | |
| consignee | string | 是 | 收货人 | |
| mobile | string | 是 | 收货联系方式 | |
| delivery_list | array | 否 | 发货列表 | |
| id | int | delivery_list | 否 | 发货单ID |
| state | int | delivery_list | 否 | 发货单状态(2已发货;3已收货) |
| trade_no | string | delivery_list | 否 | 订单号 |
| express_company | string | delivery_list | 否 | 快递公司 |
| express_no | string | delivery_list | 否 | 快递单号 |
| express_at | string | delivery_list | 否 | 发货时间 |
| remark | string | delivery_list | 否 | 备注 |
| trade_state_log | array | 否 | 订单状态日志 | |
| skus | array | 是 | 商品列表 | |
| id | int | skus | 是 | 订单商品明细id此id后续用来发货 |
| created_at | string | skus | 是 | 创建时间 |
| updated_at | string | skus | 是 | 更新时间 |
| trade_no | string | skus | 是 | 订单号 |
| product_uid | string | skus | 是 | 商品uid(spu id) |
| sku_uid | string | skus | 是 | sku_uid(sku id) |
| sku_title | string | skus | 是 | 商品标题 |
| spec | string | skus | 是 | 规格 |
| cate_id | int | skus | 是 | 类目ID |
| cate_ids | array | skus | 是 | 类目IDS |
| thumb | string | skus | 是 | 缩略图 |
| quantity | int | skus | 是 | 数量 |
| sale_price | float | skus | 是 | 销售价格 |
| quantity_returned | int | skus | 是 | 退货数量 |
| quantity_after_sale | int | skus | 是 | 售后数量 |
| freight | float | skus | 是 | 运费 |
| total_price | float | skus | 是 | 总价(含运费) |
| is_commented | bool | skus | 是 | 是否评论 |
| send_quantity | int | skus | 是 | 已发货数量 |
| is_refund | int | skus | 是 | 退款状态 |
| tax_rate | float | skus | 是 | 商品税率 |
| tax_code | string | skus | 是 | 税收编码 |
业务数据解密后示例 #
{
"trade_no": "2240528020660001",
"created_at": "2024-05-28 00:34:26",
"updated_at": "2024-05-28 00:34:26",
"state": 20,
"total_price": 119,
"total_freight": 4,
"remark": "订单留言呢",
"paid_at": null,
"cancel_reason": "",
"skus": [
{
"id": 211,
"created_at": "2024-05-28 00:34:26",
"updated_at": "2024-05-28 00:34:26",
"trade_no": "2240528020660001",
"product_uid": "21457210789863424",
"sku_uid": "21457210794057728",
"sku_title": "测试商品 ",
"spec": "001",
"cate_id": 488,
"cate_ids": [
83,
160,
488
],
"thumb": "https://inews.gtimg.com/om_bt/OrMpVlRiNYrhEguaKDCMIlZsS55hdV-D-et1bOaKIa459.jpg",
"quantity": 1,
"sale_price": 15,
"quantity_returned": 0,
"pay_gift_card": 0,
"freight": 2,
"total_price": 17,
"is_commented": false,
"send_quantity": 0,
"is_refund": -1,
"quantity_after_sale": 0,
"tax_rate": 0.13,
"tax_code": "1060202010000000000"
},
{
"id": 212,
"created_at": "2024-05-28 00:34:26",
"updated_at": "2024-05-28 00:34:26",
"trade_no": "2240528020660001",
"product_uid": "29036010360807424",
"sku_uid": "29036010952204288",
"sku_title": "API测试商品 ",
"spec": "",
"cate_id": 539,
"cate_ids": [
83,
170,
539
],
"thumb": "https://inews.gtimg.com/om_bt/OrMpVlRiNYrhEguaKDCMIlZsS55hdV-D-et1bOaKIarf8AA/641",
"quantity": 1,
"sale_price": 100,
"quantity_returned": 0,
"pay_gift_card": 0,
"freight": 2,
"total_price": 102,
"is_commented": false,
"send_quantity": 0,
"is_refund": -1,
"quantity_after_sale": 0,
"tax_rate": 0.13,
"tax_code": "1060202010000000000"
}
],
"total": 2,
"trade_state_log": null,
"province": "天津市",
"city": "南开区",
"district": "阿鲁科尔沁旗",
"address": "收货地址",
"consignee": "收货人",
"mobile": "13699999999",
"delivery_list": null
}