当前位置：文档之家 › 在线支付网关接口说明

在线支付网关接口说明

  • 格式：docx
  • 大小：60.09 KB
  • 文档页数：8

南京网乐天下购支付网关接口说明
Version: 1.0
Public date: 2008-09-25
All copyright reserved
1. 文档描述
1.1 文档说明
此文档用来指导银行支付网关开发人员与天下购电子商务支付网关系统的顺利对接。

请相关技术人员详细阅读本文档。

文中黑粗的内容表示要重点注意的内容。

1.2 版本
接口基于HTTP协议实现，各种平台，只要支持HTTP协议，各种语言均可实现。

1.3 阅读对象
天下购开发人员
银行支付网关相关技术人员
1.5 术语约定
2. 业务功能描述
2.1 作业流程简述
1)商户根据用户的支付行为生成订单，包括商户号、订单号、金额、等支付要素，并提
交付款请求。

（订单付款状态为未付款）
2)用户支付成功以后，银行支付网关使用后台调用方式将支付结果实时通知给商户系
统。

3)商户接收到银行支付网关的支付通知请求后，输出反馈信息给银行支付网关，并完成
相关业务逻辑。

（订单付款状态为已付款）
4)银行支付网关接收到商户返回的成功信息并完成相关业务处理后，再将用户引导回商
户网站。

（订单付款状态为已结束）
2.2 作业流程详述
1)用户在商户系统上选择商品，确认提交订单付款。

2)商户系统根据用户选择商品，生成付款订单，包括商户号、订单信息、订单明细及相
关签名信息，并提交到银行支付网关。

3)银行支付网关验证签名数据有效后，检查商户订单号，并向导用户完成支付操作…此
处由各银行支付网关自由实现(登录，付款)。

4)用户完成支付操作后(冻结金额)，银行支付网关使用后台调用方式将用户付款信息通
知给商户系统。

通知中包含商户号、付款订单信息、付款订单明细及相关签名信息。

其中付款订单允许和商户系统中的订单不一致，因为用户积分可能不足以支付此次订单中的所有商品，所以允许用户在银行支付网关中选择部分商品进行支付。

注意商品只能从商户订单中进行选择，且价格等商品信息不能变更。

5)商户系统接收到银行支付网关的支付通知请求后，进行签名验证并处理相关业务逻辑
(将定单置为已付款)，处理成功后返回8080信息码，其它结果皆为处理失败，包括无响应。

a)若商户系统未成功处理，则银行支付网关要求根据返回的错误码友好提示用户支
付失败(释放冻结金额)，并记录日志。

b)若商户系统无响应，应该记录警报日志，并提示用户支付失败(释放冻结金额)。

c)若商户系统处理成功并返回8080信息码，则银行支付网关提交支付扣款，成功
后将用户引导回到商户系统中。

6)商户系统收到引导回的信息，将交易置为结束，提示交易成功页。

●导常状态
⏹若商户收到银行支付网关的支付信息后，将定单置为已付款，此时出现故障，消息
未发送到银行支付网关，银行支付网关将此通知视为无响应处理，直接取消支付。

⏹银行支付网关提交扣款后出现故障，商户系统未收到引导回的信息，既定单状态为
已付款状态，则定单醒目提示，要求人工核对银行账单数据。

2.2 接口通知流程
1)返回结果
在此通知接口模式中，商户需要确保notify_url（通知回调地址）稳定可靠。

在notify_url 完成接收并成功处理银行支付网关发送的支付结果信息后，银行支付网关将用户传回至商户系统。

银行支付网关只将支付成功的订单进行返回传递。

在传送的参数中，包含使用双方约定的MD5密钥签名的sign参数，应该先验证该数字签名，确认该通知信息的合法性。

然后完成相关业务逻辑。

2)输出反馈
返回8080为成功，其它皆为失败，包括无返回
3)用户返回
银行支付网关接收到以上反馈信息后，将引导用户返回至return_url。

2.3 安全控制
1．银行支付网关采用加密和数字签名认证体系
2．通讯使用SSL协议（128位），对数据进行加密
3．商户和银行支付网关之间数据交互都使用加密，并使用数字签名进行数据验证，确保数据的完整性。

3. 支付请求接口协议
3.1 接入URL
https://www.**/pay /
3.2 接入方式
POST方式
3.3 协议参数
3.4 签名规则
对所有请求字段，其值为空的不加入MD5验证
对所有请求字段，按字段名的ASCII顺序进行连接，连接方式同URL参数连接方式，使用& key=总是附加在签名串的最后，不参与ASCII排序。

MD5的结果转化为小写。

4. 通知接口协议
4.1 通知url
商户提供的notify_url ，当用户付款成功，调用notify_url跳转后，浏览器会把链接导向到return_url，参数与notify_url一致
4.2 通知方式
POST 方式
4.3 协议参数
5. 其他
5.1 接口联系人
5.2 版权说明
此文档版权归南京网乐信息科技有限公司（以下简称南京网乐）所有。

作为本系统的最终用户，可以拥有该份文档的使用权，但未征得南京网乐的书面批准，不得为任何目的、以任何形式或手段（包括但不限于机械的或电子的）复制或传播本文档的任何部分。

对于本文档涉及的技术和产品，南京网乐拥有其专利（或正在申请专利）、商标、版权或其它知识产权。

除非得到南京网东的书面许可协议，本文档不授予这些专利、商标、版权或其它知识产权的许可。

本文档因产品功能示例和描述的需要，所使用的任何人名、企业名和数据都是虚构的，并仅限于南京网乐公司内部测试使用，不等于南京网乐有对任何第三方的承诺和宣传。

本文档的解释权属于南京网乐。

若本文档内容有变动，恕不另行通知。

合集下载

交易网关step接口规格说明书（互联网交易平台）

交易网关step接口规格说明书（互联网交易平台）

上海证券交易所交易网关STEP接口规格说明书（互联网交易平台）V1.132二〇二三二年七八月文档版本目录第一章前言 (5)1.1 目的 (5)1.2 术语和定义 (5)1.3 参考文档 (5)1.4 联系方式 (6)第二章系统简介 (7)2.1 系统接入 (7)2.2 业务范围 (7)第三章交互机制 (9)3.1 会话机制 (9)3.1.1 建立会话 (9)3.1.2 关闭会话 (9)3.1.3 维持会话 (10)3.1.4 其他约定 (10)3.2 申报与回报 (10)3.2.1 业务类型 (11)3.2.2 消息流图 (12)1.1.1 平台状态 (18)1.1.2 重复订单 (19)1.1.3 执行报告 (20)3.3 恢复场景 (21)3.4 订阅机制 (22)第四章消息定义 (23)4.1 消息结构与约定 (23)4.1.1 数据类型 (23)4.1.2 STEP格式约定 (24)4.1.3 STEP消息头 (24)4.1.4 STEP消息尾 (25)4.1.5 STEP消息完整性 (25)4.2 会话消息 (25)4.2.1 登录消息（MsgType=A） (25)4.2.2 注销消息（MsgType=5） (26)4.2.3 心跳消息（MsgType=0） (27)4.2.4 测试请求消息（MsgType=1） (27)4.2.5 重发请求消息（MsgType=2） (27)4.2.6 会话拒绝消息（MsgType=3） (28)4.2.7 序号重设消息（MsgType=4） (28)4.2.8 订单业务类 (29)4.2.9 询价业务类 (35)4.2.10 执行报告类 (47)4.2.11 网络密码服务（Password Service） (5251)4.2.12 其它消息 (54)第五章附录 (57)5.1 附一计算校验和 (57)5.2 附二PBU及说明 (57)5.3 附三错误代码说明 (58)5.4 附四“用户私有信息”说明 (58)第一章前言1.1目的本接口规范描述了上海证券交易所（以下称本所）交易网关与市场参与者系统之间以STEP协议进行交易数据交换时所采用的交互机制、消息格式、消息定义和数据内容。

电子商务支付网关协议(标准版)

电子商务支付网关协议(标准版)

电子商务支付网关协议本协议由以下双方签订：甲方：（以下简称“商家”）乙方：（以下简称“支付网关提供商”）鉴于甲方为开展电子商务业务需要使用支付服务，乙方为提供支付服务，双方经协商一致，就甲方使用乙方支付服务事宜，达成如下协议：第一条定义1.1 支付服务：乙方提供的将交易款项从买方账户转移到甲方账户的服务。

1.2 交易金额：指买方通过乙方支付服务进行的交易涉及的金额。

1.3 手续费：乙方按照约定向甲方收取的服务费用。

第二条支付服务内容2.1 乙方应向甲方提供安全的支付服务，确保交易款项能够及时、准确地划转到甲方账户。

2.2 乙方应保证支付服务的稳定性，确保交易系统正常运行。

2.3 乙方应对甲方的交易数据保密，不得泄露给第三方。

第三条手续费3.1 乙方向甲方提供支付服务，按交易金额的一定比例收取手续费。

3.2 双方应在签订本协议时明确手续费比例，并在协议有效期内保持不变。

3.3 甲方应在收到乙方开具的发票后，按约定时间支付手续费。

第四条结算4.1 乙方应在交易完成后的一定时间内将交易款项划转到甲方账户。

4.2 甲方应在收到交易款项后的一定时间内核实金额无误，并向乙方出具结算确认书。

4.3 双方应在每月最后一个工作日之前完成上一个月的结算。

第五条违约责任5.1 乙方未按照约定时间、金额划转交易款项的，应向甲方支付违约金。

5.2 甲方未按照约定时间支付手续费的，应向乙方支付违约金。

5.3 双方因违反本协议导致对方损失的，应承担赔偿责任。

第六条终止和解除6.1 双方同意解除本协议的，应提前一个月书面通知对方。

6.2 乙方未按照约定提供支付服务，甲方有权解除本协议。

6.3 本协议解除或终止后，乙方仍应承担因本协议履行产生的违约责任。

第七条争议解决双方因履行本协议发生争议的，应首先通过友好协商解决；协商不成的，可以向有管辖权的人民法院提起诉讼。

第八条其他约定8.1 本协议一式两份，甲、乙双方各执一份。

8.2 本协议自双方签字（或盖章）之日起生效，有效期为____年。

工行B2C在线支付接口说明

工行B2C在线支付接口说明

中国工商银行网上银行B2C在线支付接口说明一、B2C流程说明：1、客户在商户网站浏览商品信息，签订订单；2、商户按照工行B2C订单数据规范形成提交数据，并使用工行提供API和商户证书对订单数据签名，形成form表单返回客户浏览器，表单action地址指向工行接收商户B2C订单信息的servlet；3、客户确认使用工行支付后，提交此表单到工行；4、工行网银系统接收此笔B2C订单，对订单信息和商户信息进行检查，通过检查则显示工行B2C支付页面；5、客户在此页面可以查询客户在银行的预留信息；也可以输入支付卡号、支付密码、验证码进行B2C支付；6、工行检查客户信息，通过检查后显示确认页面；客户确认提交后工行进行支付指令处理；7、工行进行支付指令处理后，如果商户需要工行实时通知，则工行将处理结果使用http协议post方式将通知消息数据提交到商户网站（这个接收银行通知消息的商户端地址是随商户订单数据提交银行的merURL字段），商户返回取货地址或关闭这个银行与其建立的连接后，银行才显示交易结果页面给客户。

（注意1、发送通知和显示结果页面是串行的，所以商户端接收银行通知处理时间太长可能导致客户等待超时，造成银行不能将交易结果页面显示给客户。

2、此连接是银行服务器自动和商户进行的连接，商户返回也是直接返回给银行，商户端不能对银行的这个请求进行重定向。

）8、工行进行支付指令处理后，如果商户不需要工行实时通知，则工行直接显示交易结果给客户。

二、B2C接口数据说明：接口数据格式定义通过接口名称和接口版本号来标识，以便将来的扩展；以下数据格式为“1.0.0.0”版的“ICBC_PERBANK_B2C”接口定义。

2.1 B2C商户提交表单接口定义：注：1、数据中不能包含“|”“&”“=”，此字符为银行端程序保留字符；中文变量使用GBK编码，另请注意与C2C接口定义字段名称和大小写有区分2、从商户Post过来的数据，参数名的名称必须与上表中完全相同，名称中的字母大小写均要相同，不能进行随意更改(在form中的提交按钮<input type=”submit”……>中submit不能有Name属性)；此外，如果其他input项的Name中使用了双引号，如：<input type=text name="merURL " value="/ICBCPay/">，则一定注意在引号内不要包含空格，不要写成“mer URL ”，如果拼写错误或者多了空格，将造成数据无法识别，无法正常进行支付3、接口名称和版本号一定要和上表中相同.。

BC支付网关接入方案

BC支付网关接入方案

B2C支付网关接入方案一、支付宝1、个人帐户接入A）申请支付宝。

B）实名认证和银行卡认证（需要身份证扫描件和银行卡）。

C）签署支付协议。

个人帐户需提供信息如下图:资费:你要和支付宝签订协议，才有交易安全校验码（key），有了这个，才可以使用，现在支付宝推出了免费集成的服务，手续费是1.5%2、企业帐户接入◆签约、开通流程第一步：确认合作套餐，并通知您的客户经理—吴伟军第二步：确认要用来收款的帐户，如没有帐户先新注册一个支付宝账户，注册地址：，注册完成后告知客户经理账户名称。

(企业注册实名认证需要营业执照，银行开户许可证)第三步：客户经理发起在线协议，然后您登录支付宝账户—商家服务—合同列表—特约商家服务协议—右侧“查看”点击后打开协议—右下角点“同意”—系统自动发起催款，在线支付预存款。

第四步：次日早上开始测试和安装接口。

支付宝免费提供技术支持。

快钱支付网关接入1）有自己的网站，网站需要通过ICP备案2）快钱帐户注册名称必须与ICP备案的名称一致，网站必须能打开。

3）在线注册（同时提交营业执照扫描件）4）银行账号待快钱审核后再绑定开通流程：登录快钱首页—点击注册企业用户—填写相关信息—上传营业执照副本—专人审核—审核通过发送帐户激活邮件—激活成功--登录快钱帐户—快钱工具—自助开通人民币网关—签定在线协议如资料都符合会发送产品支付密钥并在邮件中会有快钱的开发者平台下载代码范例使用我们提供的测试工具调试网关接口。

资费：快钱会收取每笔成功交易1%的标准费率（线下支付1元/笔）企业用户提现手续费为单笔0.1%最低5元，最高50元。