为了账号安全,请及时绑定邮箱和手机立即绑定
首页 手记 商城系统针对开发者自有支付系统提供的解决方案

商城系统针对开发者自有支付系统提供的解决方案

2018.08.21 21:40 1127浏览

一、引言
1.1 文档概述
本文件描述Mob ShopSDK针对开发者自有支付系统提供的解决方案(即您可以使用您的自有支付系统接入shopSDK,支付系统对接的财务对账系统等均可以不做修改,方便您更好的接入ShopSDK)。文档分别从签名、接口、注意事项等方面详细介绍了Mob ShopSDK的工作方式和开发过程,可以帮助开发人员快速入门并掌握开发技能,同时也可以作为日后接口参数以及参数类型的速查手册。
1.2 阅读对象
供使用您自有的支付系统接入ShopSDK的技术或业务人员参考和查询。
1.3 业务术语

图片描述
二、方案概述
2.1 行业背景
在电子商务中,商家、买家、中间服务方是交易活动中的三个环节。买家选购商品下发订单,商家确认订单,买家通过支付服务方向商家支付货款,商家发货履行订单。
针对于开发者自有支付服务,EtradeSdk提供接口和开发者自有支付服务进行对接,为开发者提供更友好体验.
接口介绍

图片描述
2.2 加解密流程图

图片描述
2.3 业务流程图

图片描述

图片描述
三、数据格式
3.1 请求方式
采用HTTP标准的POST协议,为了保证接收方接收数据正确,传递的参数如果存在特殊字符(如&、=等)需要进行URL Encode。
3.2 响应格式
直接以简单字符串作为数据内容,一般用于后台通知模式的接口反馈,表示处理是否成功。

图片描述
四、数字签名
为了保证数据传输过程中的数据真实性和完整性,我们需要对数据进行数字签名,在接收签名数据之后进行签名校验。
数字签名有两个步骤,先按一定规则拼接要签名的原始串,再选择具体的算法和密钥计算出签名结果。
一般失败的结果不签名。
4.1 签名原始串
所有参数按照字段名的ascii码从小到大排序后使用QueryString的格式(即key1=value1&key2=value2…)拼接而成
参数最后一位为appsecret:值(该值为开发者appkey关联信息)拼接前面参数,使用MD5加密,生产签名
3、签名原始串中,字段名和字段值都采用原始值,不进行URL Encode。
举例:
调用某个接口,接口有如下字段:
partner、total_fee、desc、attach
实际调用接口时,各字段的值:
partner=1900000109,total_fee=1,desc=a&b,attach=,test=1
正确的签名原始串是:
desc=a&b&partner=1900000109&test=1&total_fee=1
常见的错误有:
desc=a%26b&partner=1900000109&test=1&total_fee=1
desc=a&b&partner=1900000109&total_fee=1
attach=&desc=a&b&partner=1900000109&test=1&total_fee=1
partner=1900000109&total_fee=1&desc=a&b&test=1
4.2 签名算法
目前暂只支持MD5签名
MD5签名
MD5 是一种摘要生成算法,通过在签名原始串后加上商户通信密钥的内容,进行MD5运算,形成的摘要字符串即为签名结果。为了方便比较,签名结果统一转换为大写字符。
注意:签名时将字符串转化成字节流时指定的编码字符集应为utf-8。
MD5签名计算公式:
sign = Md5(原字符串& appsecret =开发者appsecret). toUpperCase
如:
签名原始串是: partner=1900000109&total_fee=1
开发者appsecret是:8934e7d15453e97507ef794cf7b0519d
签名的结果为:
sign=md5(input_charset=GBK&partner=1900000109&total_fee=1&appsecret=8934e7d15453e97507ef794cf7b0519d)= 4C513CB879523CA9D717EEA7819DEB0C
五、接口
5.1 对接自有支付系统订单支付状态变更接口
5.1.1 业务功能
订单支付状态变更
5.1.2 请求参数列表
请求url:http://openapi.shop.mob.com/thirdparty/ertrance/updateOrderStatus
通过post请求

图片描述
JSON格式:
{
“orderId”:90892555608600576,
“appkey”:”221a0c04f52d4″,
“totalMoney”:1000,
“payTicket”:”123a”,
“paidMoney”:800,
“payStatus”:1
}
5.1.3 返回结果参数列表
数据按json的格式实时返回

图片描述
成功示例:
{
“status”: 200,
“message”: “”,
“data”: “”
}
5.2 对接自有支付系统订单查询接口
5.2.1 业务功能
订单查询接口
5.2.2 请求参数列表
请求url: http://openapi.shop.mob.com/thirdparty/ertrance/queryOrderDetail
通过post请求

图片描述
JSON格式:
{
“orderId”:90892555608600576,
“appkey”:”221a0c04f52d4″
}
5.2.3 返回结果参数列表

图片描述
成功示例:
{
“status”: 200,
“message”: “”,
“data”: {
“orderId”: 2,
“paidMoney”: 201,
“totalMoney”: 1000
}
}
5.3 对接自有支付系统退款商品查询接口
5.3.1 业务功能
退款商品查询接口
5.3.2 请求参数列表
请求url:http://openapi.shop.mob.com/thirdparty/ertrance/queryRefundList
通过post请求

图片描述
JSON格式:
{
“appkey”:”221a0c04f52d4″,
“orderBeginAt”:”2017-11-28 11:50:13″,
“orderEndAt”:”2017-12-28 11:50:13″,
“refundApplyBeginDate”:”2017-11-2811:50:13″,
“refundApplyEndDate”:”2017-12-28 11:50:13″,
“orderId”:12346567512,
“productName”:”毛巾”,
“buyerId”:”1245233A”,
“pageIndex”:1,
“pageSize”:10
}
5.3.3 返回结果参数列表

图片描述
成功示例:
{
“status”: 200,
“message”: “”,
“data”: {
“pageIndex”: 1,
“count”: 1,
“list”: [
{
“refundCommodityId”: “98830451051405312”,
“refundFee”: 100,
“orderPaidMoney”: 100,
“orderId”: “99140624904790016”
}
]
}
}
5.4 对接自有支付退款状态变更接口
5.4.1 业务功能
对接自有支付系统退款进度状态变更。
5.4.2 请求参数列表
请求url:http://openapi.shop.mob.com//thirdparty/ertrance/updateRefundStatus
通过post请求

图片描述
JSON格式:
{
“appkey”:”221a0c04f52d4″,
“refundList”:
[
{
“refundCommodityId”:90892555608600576,
“refundFee”:100,
“status”:0
}
]
}
5.4.3 返回结果参数列表
数据按json的格式实时返回

图片描述
成功示例:
{
“status”: 200,
“message”: “SUUCCESS”,
“data”: “”
}
六、注意事项
所有涉及到金额的单位都是分,最小的单位是1分,不能有小数出现
请求头中必须携带appkey以及mobsign信息
RSA加密算法,MD5签名算法详细见附件
加密方法
在对接前需前往MOB后台管理页面获取公钥,输入您的服务器外网IP
图片描述

原文链接:http://www.apkbus.com/blog-944804-77179.html

点击查看更多内容
0人点赞

若觉得本文不错,就分享一下吧!

评论

作者其他优质文章

正在加载中
手记
粉丝
60
获赞与收藏
327

关注TA,一起探索更多经验知识

同主题相似文章浏览排行榜

风间影月说签约讲师

51篇手记,涉及Java、MySQL、Redis、Spring等方向

进入讨论

Tony Bai 说签约讲师

152篇手记,涉及Go、C、Java、Python等方向

进入讨论
感谢您的支持,我会继续努力的~
扫码打赏,你说多少就多少
赞赏金额会直接到老师账户
支付方式
打开微信扫一扫,即可进行扫码打赏哦
意见反馈 帮助中心 APP下载
官方微信

举报

0/150
提交
取消