星启天51支付网关商户公共接口规范(组卡支付).doc

星启天51支付网关商户
公共接口规范(组卡支付)
(隐形平台解决方案)

版本
日期
作者
注释
审核

2010-9-10
星启天技术团队
制作文档
汪骏
安徽星启天网络技术有限公司
目录
第一章文档说明 5
文档概述 5
阅读对象 5
相关术语 6
技术支持 7
第二章接口开发 7
开发准备 7
功能说明及流程 8
功能流程图 9
逻辑功能及流程 10
支付订单请求 11
功能描述 11
接口详细说明 12
接口注意事项 14
. 支付订单请求同步返回 15
功能描述 15
15
接口注意事项 16
支付订单结果异步通知 17
功能描述 17
接口详细说明 17
接口注意事项 18
支付订单结果异步通知商户返回 18
功能描述 18
19
接口注意事项 19
支付订单状态查询请求 20
功能描述 20
20
接口注意事项 21
支付订单状态查询同步请求返回 21
功能描述 21
21
接口注意事项 23
接口开发注意事项 23
第三章参考资料 25
常见问题(FAQ) 25
提问:如何获取51支付网关商户账户? 25
提问:如何获取或修改51支付网关密钥(key)? 25
提问:如何查询交易记录? 25
提问:商户账户资金如何提出? 25
提问:订单状态一直没更新怎么办? 26
版权说明 26
关于我们 26
附录表1 卡面值编号表 27
附录表2 MD5签名顺序表 31
附录表3 错误代码表 32
文档说明
文档概述
本文档的目的是为51支付网关定义一个商户公共接口规范,对外部商户系统与51支付网关开放平台协作中的交互模式、安全机制、外部系统接入与管理方式等制定统一的标准。
本文档将以业务流程为主线,将星启天网络有限公司(下称“星启天”)的51支付网关商户公共接口进行介绍,以便商户能够更好的,顺利的完成对星启天网络有限公司所提供接口的了解、集成。
本套技术接口适用于隐形平台下的用户在商户平台充值,商户进行收款的用户。需要和星启天签署支付协议才可以完全使用以下功能。
阅读对象
使用51支付网关的商户的商户系统开发人员、技术实施人员、系统维护人员等。其中的部分内容也可供合作伙伴的管理与业务人员参考。
相关术语
名称
说明
隐形平台
用户在商户平台完成所有的充值,查询,资金结算等操作;商户平台在系统内部通过和51支付网关商户公共接口,完成订单提交,,订单充值,订单返回结果等操作。
商户
和星启天进行业务合作的商户。
用户
指在商户系统平台上消费或购物的企业或个人。
充值
指用户在商户系统平台购买相关产品或服务,进行充值。
商户ID
签约注册后,星启天为商户自动分配的唯一编号。
同步返回
当商户提交订单到51支付网关,51支付网关同步返回以xml格式形式显示商户订单提交的结果,注意:此时只表示商户订单是否已经成功提交到51支付网关,不表示订单是否已经处理成功。
异步通知
当商户成功提交订单到51支付网关,51支付网关进行处理后,异步通知商户该订单的结果。
通知页
参数名称noticeurl,所指定的互联网HTTP地址,当51支付网关处理完订单之后,发送信息到该页面去(异步通知),即调用该页面,该页面中的程序自动运行,并判断请求与处理获取到的信息
技术支持
如果您有任何技术上的疑问,可按如下方式寻求帮助:
技术支持QQ: 267169392
其它支持方式由商户的星启天51支付网关客户经理提供
技术支持时间:周一到周五8:30-17:30
接口开发
开发准备
商户技术开发人员在开发之前,应该首先熟悉商户自身网站购物系统流程及开发技术,同时也需要了解51支付网关流程(请务必认真阅读本接口开发文档,如果有任何疑问可以及时和星启天的技术进行沟通),在考虑清楚两者集成的具体方法之后,再进行接口开发工作。另外,商户开发人员在确认好以上工作之后,应该做好如下准备工作:
申请商户系统在51支付网关商户账号,密钥等(需要商户的商务人员联系星