兑吧服务流程

更新兑换记录

免登陆URL接口生成兑吧URL 配置uid参数为not_login来标识游客用户

展示商城游客界面

通知兑吧：积分操作成功/失败

返还资金

兑吧商城游客界面

更新订单状态

兑吧

已登录 传递用户名密码

未登录

成功

失败

显示失败信息如：积分不足

服务器

用户产生消费行为

免登陆URL接口记录用户登录状态服务端根据用户id查询用户积分，使用兑吧的免登陆接口生成免登陆URL，服务端将生成的免登陆URL响应给客户端做重定向跳转（302 redirect）

免登陆URL

预扣并通知扣积分

302重定向访问兑吧商城页面

服务器接口

请求

是否登录

响应302跳转

功能： 用户在积分商城页面下单，兑吧服务器收到下单请求后会先向开发者服务端发送扣积分请求，开发者收到请求后需判断用户是否有足够积分下单，如果用户积分充足则预扣用户积分并返回成功的响应；如果积分不足或者其它不允许兑换的限制则返回扣积分失败的响应，并带上失败原因（兑吧会在手机端将失败原因展示给用户）。实现： 根据兑吧扣积分请求的文档参数设计数据库表结构，用于存放用户扣积分订单记录，建议对兑吧订单号order_num字段做索引。参考建表语句（见文末附录一）。处理兑吧扣积分请求时需做MD5验签，根据自身系统实现扣积分逻辑，扣积分为多服务器异步请求，需处理并发。兑吧订单号order_num唯一，且一个order_num只会发送一次扣积分请求。

结果通知接口成功：更新状态订单完成失败：更新状态返回积分

兑吧服务器创建订单

弹出登录模块登录

执行兑换流程

根据服务器操作状态，执行兑换流程

功能： 用户在兑吧兑换商品成功/失败后，兑吧服务端都会发请求告知开发者，如果兑换失败，此接口需要根据之前扣积分的情况，返还用户积分。实现： 收到兑吧的结果通知接口后，先验签名，验签通过后根据order_num查询扣积分订单表。查询到如果有该订单，判断订单状态是否为已处理，如果已处理的话就忽略并返回 ok。如果通知接口返回兑换成功，将订单状态置为成功；如果为兑换失败，则订单处理为失败，并根据积分状态是否为预扣来决定是否返还积分。结果通知请求为了确保开发者收到，会重发最多5次，处理请求后兼返回纯字符串 ok ，兑吧会停止重发。

过程

客户端

通知服务器

访问积分商城

用户发起兑换请求/活动请求

扣积分接口扣除用户本次兑换所用的积分

传递用户名密码

已登录兑吧商城

兑吧使用流程