合作对接-向上电子商务.pdfVIP

特别说明：

1.由于网络、充值程序、数据库等，有可能出现订单发送后，出现订单查询不到

的现象，为了避免不必要的损失，请延时5分钟在进行查询，或者重新发起充值请求，

不可将该错误直接判定为充值失败。

2.在查询过程中,出现除非明确返回订单失败OrderFail,否则不能判定订单失败

1.引言

1.1.目标

本文档的目的是为向上话费充值系统定义一个直连公共接口规范，对外部直连

系统与向上话费充值系统开放平台协作中的交互模式、安全机制、外部系统接入与管理方式

等制定统一的标准。同时也帮助直连技术人员接入向上话费充值系统，并快速掌握相关

功能，便于尽快投入使用。

1.2.名词定义

ＲＳＡ签名：采用RSA（SHA1）进行数字签名

合作商系统：与向上话费充值系统对接，进行话费充值的系统。

订单结果通知：向上话费充值系统充值完成后，会议HTTP的方式通知合作商系统。

1.3.参考文献

1、RSA算法

2、

2.概述

2.1.概述

向上话费充值系统接口使用HTTPS传输数据，兼容POST/GET方式连接并发送信息。每

个HTTP请求发送后，合作商系统在接收并处理请求时必须首先保证整个处理流程（至少是

对请求信息的保存步骤）确保成功后，才能返回给发送端确认信息。当合作商系统接收到确

认信息后，才认为整个请求被成功发送。

在某些要求务必送达的请求中，上述通知-确认流程必须由接收端确保，如果合作商系

统不能接收到正确响应将会按照一定的逻辑重复发送请求。

目前的协议中，订单结果通知是必须送达合作商系统的信息。

2.2.流程

合作商系统按文档要求将充值请求的相关信息如被充值号码、充值金额等参数发送到向

上话费充值系统接口，向上话费充值系统接口生成订单并扣除合作商的钱款。

向上话费充值系统处理完成后会异步通知直连人支付结果，合作商系统在接收

到订单处理结果，可以对数据库进行相应更新，并在显示给用户的页面中做出相应提示,

由于网络故障或其它导致合作商系统没有正确接收支付结果时，合作商系统可以调用

“4.3订单查询”接口查询订单的状态。

2.3.相关约定

1、通讯通道采用HTTPS安全通道，兼容POST或GET方法进行数据传输，接口中数据采用

UTF-8进行编码

2、向上话费充值系统收到合作商请求后，结果以ＸＭＬ的方式返回，合作商应对返回数据

进行ＸＭＬ方式解析

3、向上话费充值系统在订单处理完结后，会以HTTPPOST的方式通知合作商系统，通知超

时时间为5秒，超时后延时1分钟重试，重试15次，不会在通知

4、本接口采用RSA单向加密算法进行签名验证，签名数据采用UTF-8编码，消息采用

SHA1

5、接口所有参数的参数名一律采用小写

6、向上话费充值系统具有幂等性，在下单时出现网络错误、系统错误等情况时，务必使用

原先的订单号重新下单

7、在订单查询时，向上话费充值系统除非返回明确状态，不可视订单失败

8、向上充值系统的公钥会定期进行更换，以保证时效性。合作商系统应具备能力，快速更

换公钥而不至于充值业务受影响。

2.4.RSA签名

根据参数名称将所有请求参数按照字母先后顺序排序:key+valuekey+value。例如：

将foo=1,bar=2,baz=3排序为bar=2,baz=3,foo=1，参数名和参数值后，得到拼装字符串

bar2baz3foo1，将拼装后的字符串bar2baz3foo1转换成byte[]字节流，然后采用RSA私

钥进行签名,使用公钥进行签名验证，签名时使用SHA1算法。

签名样例：

2.5.接口返回结果以XML表示

2.6.通用参数

以下表格中的参数，在每个接口请求中都需要传送

参数说明举例

time时间，1970-1-1到当前时间的秒数，该

时间与本系统的时间相差过5