导航|地址|刷新
Eshop/push - 微博API







商业API

场景接入

CLI服务

接口文档

其他服务


移动应用

网站接入

电商服务商

电商商家

微博支付

粉丝服务

龙虾助手






登录







开发文档







首页



平台政策与指引

概述

平台公约

新手指南

开发者协议

应用运营管理规范

微连接分级管理办法

应用审核产品指南

应用安全开发注意事项

平台应用设计规范

微服务接入指南



微博登录接入

用微博帐号登录

授权机制



移动应用接入

移动应用介绍

移动应用SSO授权

微博Deep Link



商业接口

商业数据接入指南

订阅服务手册(中文版)

订阅服务手册(英文版)

商业接口-REST API

商业数据常见问题



微博龙虾

微博龙虾助手介绍

微博龙虾社区介绍

智能助手玩法指南



网站接入

网站接入介绍



电商接入平台

电商服务商接入

电商商家端接入

电商平台能力接口

电商直播带货接口



粉丝服务平台

粉丝服务平台

新手接入指南

微信开发者迁移指南

接收消息

发送消息

自定义菜单

用户管理

生成带参数的二维码

Fans Service Platform



微博API

微博API

接口访问频次权限



资源下载

SDK

微博标识下载



问答中心

常见问题

智能问答-beta



联系我们



工具箱

链入页面

链出更改

特殊页面

可打印版

永久链接







跳转到： 导航, 搜索


电商商家事件通知推送


事件通知是由微博电商平台通知接入的商家，目前主要为订单事件通知，仅限虚拟商家接入。





接入流程


接入的商家需要根据自身业务的情况，维护自己的订单状态服务器。





1、开发事件通知接收请求地址


接入的自研商家，需要先开发一个用来接收事件通知的请求地址，当有事件通知时，微博电商平台将调用这个请求地址，将事件通知发送给接入的商家。





请求方式


POST





内容类型


Content-Type 为 application/x-www-form-urlencoded





请求参数

参数名称	是否必填	类型	说明描述
sign	true	string	验证签名，签名算法见 电商接口验证签名。
type	true	int	业务类型，2 - 子订单。
time	true	int	10位秒级时间戳。
data	true	string	通知内容，为JSON字符串，通过 type 判断业务类型，不同业务类型数据格式不同，具体字段见下面的 通知内容 说明。

通知内容


子订单事件，type = 2

{ "recharge_account_type": "3", "recharge_account": "1234567890", "sub_order_id": "366383890000352", "state_code": 202, "addtime": "2022-07-21 12:15:02", "pay_time": "1970-01-01 00:00:00", "buyer_id": "1766", "sku_list": [ { "goods_id": "1083814100038", "sku_id": "3924", "state_code": 502, "sold_state_code": 601, "pin": "" } ], "buyer": { "weibo_uid": "6748678500" } }

推送字段	类型	字段说明描述
recharge_account_type	int	充值账号类型，1 - 手机号码，2 - QQ账号，3 - 微信昵称。
recharge_account	string	充值账号。
sub_order_id	int64	子订单ID。
state_code	int	订单状态码，详见 电商服务商开发编码索引。
addtime	date time	创建时间。
pay_time	date time	支付时间。
buyer_id	int	买家ID。
sku_list	object array	子订单商品信息列表。
goods_id	int64	SPU ID。
sku_id	int	SKU ID。
state_code	int	SKU正向状态码。
sold_state_code	int	SKU逆向状态码。
pin	int	PIN码。
buyer	object	买家信息。
weibo_uid	string	买家微博UID。

请求响应


接入的商家收到事件通知后，需要按如下JSON格式返回相应

{ "code": 0, "msg": "", "data": {} }

返回字段	类型	字段说明描述
code	int	必需返回，返回状态码，0-正常，其他为异常。
msg	string	可选是否返回，返回的错误提示。
data	json object	可选是否返回，返回的错误数据。

2、设置事件通知接收请求地址


请登录微博电商平台 商家端 ，设置事件通知接收请求地址。












注意事项


当前支持的通知事件：订单已支付、订单已关闭


不保证消息顺序。


不保证中间态消息不丢失（仅保证终态消息不丢失）。


接口性能必需在200ms内，超时将按照补偿策略通知（补偿通知不保证时效）。


接口需要保证幂等（可能发起重复通知）。


首次通知会在2分钟内送达（99.99%的通知会在1分钟内送达）。


首次通知超时、失败，则会进行补偿通知。补偿通知最多11次，每次延时（2的N次方）分钟。


业务方需要根据自身业务处理相关异常。















来自“https://open.weibo.com/wiki/index.php?title=Eshop/push&oldid=16489”



文档更新时间: 2023-02-06










关于微博开放平台|联系我们|服务条款|无线游戏|开放平台官微

京网文 [2011] 0398-130号京ICP证100780号Copyright © 1996-2026 SINA



------
导航页 打开网址