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

一、引言

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