您的当前位置:首页网银在线支付B2C系统商户接口文档

网银在线支付B2C系统商户接口文档

2020-09-21 来源:爱问旅游网
 网银在线B2C系统商户接口文档

网银在线支付平台

B2C系统商户接口规范

版本号4.0

网银在线(北京)科技有限公司

Copyright 网银在线(北京)科技有限公司 2003-2006

网银在线B2C系统商户接口文档

目 录

1.

文档介绍 ........................................................................................................................... 1 1.1. 读者对象 ....................................................................................................................... 1 1.2. 版权声明 ....................................................................................................................... 1 2. 支付接口 ........................................................................................................................... 2

2.1. 商户 >>> 网银在线支付 ............................................................................................ 2 2.2. 网银在线支付 >>> 商户(页面返回) .................................................................... 5 2.3. 网银在线支付 >>> 商户(服务器返回) ................................................................ 6 2.4. 网关错误编码表 ........................................................................................................... 7

Copyright 网银在线(北京)科技有限公司 2003-2006

网银在线B2C系统商户接口文档

1. 文档介绍

1.1. 读者对象

商户系统设计人员、编程人员及测试人员

1.2. 版权声明

此文档版权归网银在线(北京)科技有限公司所有。作为本系统的最终用户,可以拥有该份文档的使用权,但未征得网银在线(北京)科技有限公司的书面批准,不得向第三方借阅、出让、出版该文档。

Copyright 网银在线(北京)科技有限公司 2003-2006

网银在线B2C系统商户接口文档

2. 支付接口

2.1. 商户 >>> 网银在线支付

示例程序:ChinaBank.html

用途:收集信息并发送到数据发送页即Send页

订单号:

//选填项,订单号

//选填项,总长不超过80字符 //选填项,总长不超过200个字符 //选填项,总长不超过50个字符 //选填项,总长不超过10个字符 //选填项,总长不超过100个字符

收货人姓名: 收货人地址: 收货人电话: 收货人邮编: 收货人邮件:

收货人手机号: //选填项,总长不超过13个字符 备注1:

//选填项,总长不超过150个字符 //选填项,总长不超过80字符 //选填项,总长不超过200个字符 //选填项,总长不超过50个字符 //选填项,总长不超过10个字符 //选填项,总长不超过100个字符

订货人姓名: 订货人地址: 订货人电话: 订货人邮编: 订货人邮件:

订货人手机号: //选填项,总长不超过13个字符 备注2:

//选填项,总长不超过150个字符

订单总金额(元): *必填项,譬如:0.01

示例程序:Send.asp、Send.aspx、Send.php、Send.jsp

用途:接收ChinaBank.html发送过来的数据加密后发往网银在线电子支付平台的接口网关

Copyright 网银在线(北京)科技有限公司 2003-2006

网银在线B2C系统商户接口文档

1、 支付平台网关接口地址

2、FORM表单参数

表单参数如表1,具体定义如表2。说明:蓝色部分为必填项,黄色部分与网上支付货款无关,建议不用

商户编号 订单编号 订单总金额 币种 支付动作完成后返回到该url,支付结果以POST方式发送 订单MD5校验码 备注字段1 备注字段2 收货人姓名 收货人地址 收货人电话 收货人邮编 收货人邮件 订货人姓名 订货人地址 订货人电话 订货人邮编 收货人手机号 订货人邮件 订货人手机号

Copyright 网银在线(北京)科技有限公司 2003-2006

网银在线B2C系统商户接口文档

表1

支付表单中的变量定义:

— 必填项 — 与网上支付货款无关项,建议不用

变量名称 变量命名 长度 说明 v_mid 商户编号 不可为空,以初始单所填商户编号为准。 v_oid 64 订单编号 不可为空值,订单编号标准格式为:订单生成日期(yyyymmdd)-商户编号-商户流水号。订单编号所有字符总和不可超过64位。 v_amount 8 订单总金额 不可为空,单位:元,小数点后保留两位。 v_moneytype 币种 CNY为人民币 v_url 200 消费者完成购物后返回的商URL地址 户页面,URL参数是以http://开头的完整URL地址 v_md5info 32 MD5校验码 详情见md5相关说明 remark1 150 值自定义 备注1 remark2 150 值自定义 备注2 80 v_rcvname 收货人姓名 值自定义。 200 v_rcvaddr 收货人地址 值自定义。 50 v_rcvtel 收货人电话 值自定义。 v_rcvpost 10 收货人邮编 值自定义。 100 收货人Email v_rcvemail 值自定义。 13 收货人手机号 v_rcvmobile 值自定义。 80 v_ordername 订货人姓名 值自定义。 200 v_orderaddr 订货人地址 值自定义。 50 v_ordertel 订货人电话 值自定义。 v_orderpost 10 订货人邮编 值自定义。 100 订货人Email v_orderemail 值自定义。 订货人手机号 v_ordermobile 13 值自定义。 表2

MD5校验串生成方法:当消费者在商户端生成最终订单的时候,将订单中的v_amount v_moneytype v_oid v_mid v_url key六个参数的value值拼成一个无间隔的字符串(顺序不要改变)。参数key是商户的MD5密钥(该密匙可在登陆商户管理界面后自行更改。)

MD5字符串示例:

0.01CNY19990720-1001-0000012341001http://domain/chinabank/Receive.aspkey

Copyright 网银在线(北京)科技有限公司 2003-2006

举例 1001 19990720-1001-12345。商户流水号为数字,订单号当日内不可重复 0.01 CNY http://domain/chinabank/Receive.asp 备注1 备注2 张三 北京海淀1 588156661 100081 test1@test.com 1311311311311 李四 北京海淀2 588156662 100082 test2@test.com 1311311311312 网银在线B2C系统商户接口文档

注意:得出的32位MD5值需转化为大写。(具体函数使用方法请参见接口示例) 用MD5函数加密该字符串所得值即为我们所需的订单MD5校验码,将其写入v_md5info字段即可。

2.2. 网银在线支付 >>> 商户(页面返回)

用途:支付完成后,网银支付平台通过客户浏览器页面链接返回支付结果信息给商户

示例程序:Receive.asp、Receive.aspx、Receive.php、Receive.jsp 返回的信息如下:

该消息格式详细解释如下:v_url是该笔订单提交时参数v_url 的值,即网银返回到商户的接口地址。 变量名称 变量命名 返回值说明 订单编号 支付状态 支付结果信息 支付方式 订单MD5校验码 v_oid v_pstatus v_pstring v_pmode v_md5str 商户发送的v_oid定单编号。 20(表示支付成功) 30(表示支付失败) 支付完成 支付失败 支付银行,例如工商银行 该参数的MD5字符串的顺序为:v_oid,v_pstatus,v_amount,v_moneytype,key MD5字符串示例: 20050320-1001-0000012342012.34CNYkey 用MD5函数加密上述字符串后得到的值如果和v_md5str值相等即表明返回的信息没有被纂改 Copyright 网银在线(北京)科技有限公司 2003-2006

订单总金额 币种 备注字段1 备注字段2 表3 网银在线B2C系统商户接口文档 v_amount 订单实际支付金额 v_moneytype 订单实际支付币种 remark1 remark2 2.3. 网银在线支付 >>> 商户(服务器返回)

用途:支付完成后,从网银在线支付平台服务器返回给商户支付结果信息

示例程序:AutoReceive.asp、AutoReceive.php、AutoReceive.jsp 信息格式同2.2

接口说明:

每一笔支付订单支付完成后,网银在线服务器会发送支付结果信息到商户接口程序,接口程序进行数字签名验证,验证通过则在页面输出“ok” 校验失败则输出“error”字符串。网银在线服务器在收到“ok”字符串后就不再发送该订单的支付结果信息,否则会自动按照3至4分钟的间隔频率重复发送该支付结果信息。

注意事项:

1. 商户接口程序接收网银在线返回的支付结果信息时必须验证订单的实际支

付金额是不是和商户自己的系统中原始订单金额一致。 2. 2.3接口方式为可选项,商户只需要开发2.1和2. 2两个接口程序就可以完成

全部的支付过程。

3. 使用2.3接口方式时,服务器返回的信息不带任何Session和Cookie 4. 2.3接口程序只能输出字符串“ok”或者“error”,不能有其他任何输出(包

括空格、空行),不能跳转到其他页面输出其他内容(因为此页面是后台执行的,客户是看不到的,所以跳转并没有意义)。 5. 2.3接口程序开发完成后,商户需要通知网银客服来设置该程序的URL地址。 6. 2.3接口程序实时返回银行状态,例如消费者在工商银行支付时输错密码,

工商银行会返回支付失败的信息,这时2.3接口程序会返回支付失败的信息,然后该消费者输入了正确的密码,工商银行又会返回支付成功的信息,2.3接口程序又会返回一个支付成功的信息。 7. 2.3接口程序的调用通常先于2.2页面返回。

Copyright 网银在线(北京)科技有限公司 2003-2006

网银在线B2C系统商户接口文档

2.4. 网关错误编码表

用途:在接入网关时,可以提示消费者或开发人员接口出现的问题,以便开发人员及时发现问题的出处。 错误码 100100 100101 100900 200901 200902 200903 201001 201002 201005 201006 201007 201008 201009 201010 201011 201012 201101 201102 201103 201104 201105 201106 201107 201108 201109 201110 201111 201112 201113 错误异常 服务资源未找到,请稍后重试 抱歉,出现未预期的异常 不支持的安全方式,参数有误 安全验证,加密出现异常 数据签名验证未通过 工行验证返回签名未通过,可疑银行交易 安全验证,中行MD5验证出现错误 服务拒绝,CCB签名验证错误 服务拒绝,CBP签名验证错误 服务拒绝,CMB签名验证错误 服务拒绝,CMBC签名验证错误 服务拒绝,COMM签名验证错误 服务拒绝,广发行签名验证错误 服务拒绝,广银联签名验证错误 服务拒绝,深发展签名验证错误 MASTER验证 VISA订单数据验证错误 JCB外卡验证错误 安全验证VE ,验证失败 安全验证失败 服务暂停,该号列入风险控制,交易存在风险 商户外卡支付要求3D验证 存在未知风险,或风险未明确定义 验证异常,存在风险,请稍后重试 支付超出日限额,受风险控制 支付次数过多,已列入风险控制中,请改日继续支付 支付单笔超出限额 超出单一IP支付次数 Copyright 网银在线(北京)科技有限公司 2003-2006

错误消息 网银在线B2C系统商户接口文档 201114 201300 300800 500700 500701 500702 500703 500704 500705 500706 500708 500709 500710 500800 500902 500903 501101 501102 501103 501104 501105 501106 501107 501108 501109 501110 501111 501112 501113 501114 501115 501116 501117 501118 501119 商户已列入黑名单控制 安全验证,VE验证失败 缺少必要的服务参数 参数错误,订单不能保存 请求非法,订单不存在 服务拒绝,该服务未提供 商户找不到,请确认已注册 非正常商户状态 订单支付信息未找到 操作失败,状态更新失败 参数错误,该商户ID不存在 商户未开通外卡支付 该商户未启用支付直通服务,错误的服务编码 错误的数据格式,不能解析 参数错误,缺少订单号 参数错误,订单号过长 服务拒绝,重复的服务请求 重复的服务请求 参数错误,订单号不能空 参数错误,请填写金额 参数错误,支付结果处理失败 服务可疑,支付结果金额不一致 服务超时中止,订单不存在 提交的参数有误 缺少必要的参数或参数不能识别 币种参数有误,不支持该币种 缺少必要返回参数idx,服务不能识别 参数错误,非法金额参数 参数错误,金额超出范围 参数错误,金额不能为0 返回地址过长 错误的返回地址格式 订单名称过长 订单域信息超出定义长度 订单自定义服务项过长 Copyright 网银在线(北京)科技有限公司 2003-2006

网银在线B2C系统商户接口文档 501120 501121 501122 501123 501124 501125 501126 501127 501128 501129 501130 501131 501132 501133 501604 511101 511601 511602 511603 601000 601001 601002 601003 601300 601301 601302 601303 601304 601305 601306 601307 601308 601500 601600 700000 EMAIL地址不能空 无效的EMAIL地址 无效的手机号码 提供的消息内容过长 该订单未支付 该订单支付状态失败 无效订单状态,服务拒绝 该订单已经支付成功,请勿重复支付 该订单已被禁止支付 邮政编码格式错误 购买的商品列表过多,请分次购买 无效订单,或者订单参数不能识别 该支付不支持此支付金额,无效金额 不能识别的订单版本号 服务拒绝,服务未开通 安全验证,订单验证失败 服务拒绝,错误服务编号或者该服务未开通 服务拒绝,请求的服务已经中止 服务拒绝,服务未激活 中行网络故障,服务不能提供 请求银行数据签名失败,服务中止 银行网络故障,服务不能提供 请求交通银行数据签名失败,服务中止 通信超时或服务拒绝 服务拒绝 该信用卡未在发卡行开通3D验证服务 发卡行无法对该卡认证 支付验证失败,支付取消 支付验证失败,请稍后重试 持卡人认证失败 持卡人未能成功认证或认证存在风险 与收单行通信失败,稍后重试 商户支付服务已经停止使用 请求数据时网络故障,稍后重试 您的操作超时,请重新选择支付服务 Copyright 网银在线(北京)科技有限公司 2003-2006

网银在线B2C系统商户接口文档 700001 700002 该订单多次提交,已禁止继续支付 支付结果处理失败,请与客服联系 Copyright 网银在线(北京)科技有限公司2003-2006

因篇幅问题不能全部显示,请点此查看更多更全内容