微博开放平台
微连接
移动应用
网站接入
电商服务商
电商商家
数据服务
数据服务
合作伙伴
微博支付
轻应用
粉丝服务
文档
推广
我的应用
登录
weibo
开发文档
首页
平台政策与指引
概述
平台公约
新手指南
开发者协议
应用运营管理规范
微连接分级管理办法
应用审核产品指南
应用安全开发注意事项
平台应用设计规范
微服务接入指南
微博登录接入
用微博帐号登录
授权机制
移动应用接入
移动应用介绍
移动应用SSO授权
微博Deep Link
媒体接入平台
头条文章开放接口
视频上传开放接口
电商接入平台
电商服务商接入
电商商家端接入
电商平台能力接口
粉丝服务平台
粉丝服务平台
新手接入指南
微信开发者迁移指南
接收消息
发送消息
自定义菜单
用户管理
生成带参数的二维码
Fans Service Platform
商业接口
商业数据接入指南
订阅服务手册(中文版)
订阅服务手册(英文版)
商业接口-REST API
商业数据常见问题
网站接入
网站接入介绍
微博API
微博API
接口访问频次权限
资源下载
SDK
微博标识下载
常见问题
联系我们
工具箱
链入页面
链出更改
特殊页面
查看源代码
跳转到:
导航
,
搜索
根据下列原因,你没有权限编辑本页:
您刚才请求的操作只有这个用户组中的用户才能使用:
用户
您可以查看并复制此页面的源代码:
=电商商家事件通知推送= <div class="wiki_txtJ"> 事件通知是由微博电商平台通知接入的商家,目前主要为订单事件通知,仅限虚拟商家接入。 </div> ==接入流程== <div class="wiki_txtJ"> 接入的商家需要根据自身业务的情况,维护自己的订单状态服务器。 </div> <div class="wiki_title_withline">1、开发事件通知接收请求地址</div> <div style="margin:15px 0;"> 接入的自研商家,需要先开发一个用来接收事件通知的请求地址,当有事件通知时,微博电商平台将调用这个请求地址,将事件通知发送给接入的商家。 </div> <div class="code_type">请求方式</div> <div style="margin:15px 0;"> POST </div> <div class="code_type">内容类型</div> <div style="margin:15px 0;"> Content-Type 为 application/x-www-form-urlencoded </div> <div class="code_type">请求参数</div> <div style="margin:15px 0;"> {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" <html><colgroup></colgroup></html> !width="20%"|参数名称 !width="10%"|是否必填 !width="10%"|类型 !width="60%"|说明描述 |- |sign |true |string |验证签名,签名算法见 [[ecs/api|电商接口验证签名]]。 |- |type |true |int |业务类型,2 - 子订单。 |- |time |true |int |10位秒级时间戳。 |- |data |true |string |通知内容,为JSON字符串,通过 type 判断业务类型,不同业务类型数据格式不同,具体字段见下面的 通知内容 说明。 |} </div> <div class="code_type">通知内容</div> <div style="margin:15px 0;"> 子订单事件,type = 2 </div> <pre class="brush:js"> { "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" } } </pre> <div style="margin:15px 0;"> {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" <html><colgroup></colgroup></html> !width="20%"|推送字段 !width="20%"|类型 !width="60%"|字段说明描述 |- |recharge_account_type |int |充值账号类型,1 - 手机号码,2 - QQ账号,3 - 微信昵称。 |- |recharge_account |string |充值账号。 |- |sub_order_id |int64 |子订单ID。 |- |state_code |int |订单状态码,详见 [[ecs/code_index|电商服务商开发编码索引]]。 |- |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。 |} </div> <div class="code_type">请求响应</div> <div style="margin:15px 0;"> 接入的商家收到事件通知后,需要按如下JSON格式返回相应 </div> <pre class="brush:js"> { "code": 0, "msg": "", "data": {} } </pre> <div style="margin:15px 0;"> {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" <html><colgroup></colgroup></html> !width="20%"|返回字段 !width="20%"|类型 !width="60%"|字段说明描述 |- |code |int |必需返回,返回状态码,0-正常,其他为异常。 |- |msg |string |可选是否返回,返回的错误提示。 |- |data |json object |可选是否返回,返回的错误数据。 |} </div> <div class="wiki_title_withline">2、设置事件通知接收请求地址</div> <div style="margin:15px 0;"> 请登录微博电商平台 [https://sj.e.weibo.com/ 商家端] ,设置事件通知接收请求地址。 {{Img_polaroid|src=http://wx2.sinaimg.cn/large/53b515f0ly8hap8grx0n0j20zk0g2jrx.jpg}} </div> ==注意事项== <div class="wiki_txtJ"> 不保证消息顺序。 不保证中间态消息不丢失(仅保证终态消息不丢失)。 接口性能必需在200ms内,超时将按照补偿策略通知(补偿通知不保证时效)。 接口需要保证幂等(可能发起重复通知)。 首次通知会在2分钟内送达(99.99%的通知会在1分钟内送达)。 首次通知超时、失败,则会进行补偿通知。补偿通知最多11次,每次延时(2的N次方)分钟。 业务方需要根据自身业务处理相关异常。 </div> {{#a:nobtns|noheading}} __NOTOC__
该页面使用的模板:
模板:Img polaroid
(
查看源代码
)
返回到
Eshop/push
。
反馈
分享
顶部