文档状态草案汇付宝.docx
- 文档编号:7170252
- 上传时间:2023-01-21
- 格式:DOCX
- 页数:15
- 大小:146.23KB
文档状态草案汇付宝.docx
《文档状态草案汇付宝.docx》由会员分享,可在线阅读,更多相关《文档状态草案汇付宝.docx(15页珍藏版)》请在冰豆网上搜索。
文档状态草案汇付宝
Windows8支付服务
接入手册
版本(1.0)
汇元银通(北京)在线支付技术有限公司
1.引言
1.1.编写目的
本手册是汇付宝支付Windows8安全支付服务的使用指南。
主要内容包括支付接口的调用的方法和参数说明等。
(目前仅支持骏卡支付)
1.2.应用环境
本支付接口API适用于Windows8RTM及以上各版本。
1.3.接口集成方式和发布形式
针对Windows8的安全支付服务,汇付宝支付的SDK以WindowsRuntime组件的形式提供应用程序调用。
本支付接口采用公开标准Web方式,无论开发者使用何种开发语言,汇付宝支付的SDK均提供了一致的调用接口,不同语言的开发者无需着力于处理语言之间的差异。
开发者可通过访问
2.商户准备文档
2.1.商户准备工作
1、在汇元网科技()注册成会员并实名,流程如下:
a)账户注册-----实名认证-----提现账户绑定------点卡寄售------账户收款
b)账户注册:
汇元网点卡寄售指定注册以及账户管理地址:
c) 选择点卡寄售注册
d) 申请实名认证(注:
请用户一定按照真实姓名填写,并与提现账户姓名一致,否则不支持寄售)
e)提现账户绑定
f)实名审批后,进行提现账户绑定(必须与注册账户姓名一致,否则不能提现)
g)账户收款
当用户支付成功后,系统自动结算到您的账户,t+1自动结算到您绑定的提现账户。
2、登录后,记录下页面左上角显示的商户ID。
3、检查自己服务器的IP地址(一或多个),我们将会对IP访问进行限制
4、准备好您的12位MD5钥匙码,任意组合,请牢记。
5、联系技术中心相关技术人员进行调试。
6、对产品敏感信息双方协商进行对称加密处理。
7、向商务提交准备文档时文件名要统一原则上是公司名+卡寄售接口申请+年月日.doc格式.如北京xxx公司卡寄售接口申请20120201.doc。
2.2.商户需要提交的信息
协议情况:
(必须填写)公司名、协议时间、商户协议负责人、协议状态(测试或正式签署)
商户名称:
地址:
商务联系人:
商务联系方式
技术联系人:
技术联系电话手机:
技术QQ:
800j平台注册中文名称:
800j平台注册帐户:
800j平台帐户ID号:
商户访问接口的服务器IP地址:
商户MD5码(自己编写12位字母加数字的,签名时使用):
商户DES码(自己编写24位字母加数字的,卡号卡密加密时使用):
3.使用说明
3.1.支付协议流程
客户端
代理商服务器
汇元网服务器
卡号、卡密、账号等参数
商家ID、卡号、卡密、账号等参数
结果代码、充值金额等参数
3.2.汇付宝支付SDK提供的资源
在需要使用支付服务的工程中,通过引用,将HeepayForWin8.dll这个文件,引入到工程下。
本SDK共有六个方法,分别是
1、publicboolDecrypt3DES(stringstr_string,stringtriple_des_key,outstringtriple_des_decrypt);
2、publicboolEncrypt3DES(stringstr_string,stringtriple_des_key,outstringtriple_des_encrypt);
3、publicboolMD5CreateSignForPay(stringagent_id,stringbill_id,stringbill_time,stringcard_data,stringcard_amt,stringnotify_url,stringtime_stamp,stringmd5Key,outstringsign);
4、publicboolMD5CreateSignForQuery(stringagent_id,stringbill_id,stringtime_stamp,stringmd5Key,outstringsign);
5、publicstringSubmitOrderInfo(stringagent_id,stringbill_id,stringbill_time,stringcard_data,stringcard_amt,stringclient_ip,stringnotify_url,stringdesc,stringext_param,stringtime_stamp,stringsign);
6、publicstringSubmitQueryInfo(stringagent_id,stringbill_id,stringtime_stamp,stringsign);
具体说明如下:
3.3.3DES加密
方法名称为:
Encrypt3DES,方法类型为bool类型,返回值为true时,triple_des_encrypt输出的是加密串,为false时,triple_des_encrypt输出的是错误信息。
输入参数说明:
名称
类型
说明
str_string
string
要加密的字符串信息。
triple_des_key
string
加密的秘钥。
输出参数说明:
名称
类型
说明
triple_des_encrypt
string
加密后的密文。
3.4.3DES解密
方法名称为:
Decrypt3DES,方法类型为bool类型,返回值为true时,triple_des_decrypt输出的是解密串,为false时,triple_des_decrypt输出的是错误信息。
输入参数说明:
名称
类型
说明
str_string
string
要解密的字符串信息。
triple_des_key
string
解密的秘钥。
输出参数说明:
名称
类型
说明
triple_des_decrypt
string
解密后的原文。
3.5.创建支付单的MD5签名
方法名称为:
MD5CreateSignForPay,方法类型为bool类型,返回值为true时,sign的值为加密后的签名串,为false时,sign的值为具体的错误信息。
提交和返回的参数名均小写。
输入参数说明:
名称
类型
说明
agent_id
string
商家ID(必填)800j注册的账户数字ID
bill_id
string
商家提交的唯一订单号(必填)必须唯一6到50位
bill_time
string
商户订单时间(必填格式为yyyMMddHHmmss4位年+2位月+2位日+2位时+2位分+2位秒)
card_data
string
最多支持3张,格式为:
卡号1,密码1,|卡号2,密码2,|卡号3,密码3,必填,双方协商的对称加密,使用3DES加密,合作方不能保存记录卡密)(必填)
card_amt
string
卡的总金额,单位:
元,当前寄售卡的总额(必填)
notify_url
string
单据处理后用来通知商户的地址(可选),URL参数是以http:
//开头的完整URL地址(后台处理)不填写则不通知,可通过查询接口确定单据状态
time_stamp
string
提交时间戳(必填格式为yyyMMddHHmmss4位年+2位月+2位日+2位时+2位分+2位秒)(必填)
md5Key
string
双方约定好的MD5加密秘钥(必填)
输出参数说明:
名称
类型
说明
sign
string
加密后的密文
3.6.支付单提交
方法名称为:
SubmitOrderInfo,方法类型为string类型,返回值为单提交后的响应信息。
提交和返回的参数名均小写。
输入参数说明:
名称
类型
说明
agent_id
string
商家ID(必填)800j注册的账户数字ID
bill_id
string
商家提交的唯一订单号(必填)必须唯一6到50位
bill_time
string
商户订单时间(必填格式为yyyMMddHHmmss4位年+2位月+2位日+2位时+2位分+2位秒)
card_data
string
最多支持3张,格式为:
卡号1,密码1,|卡号2,密码2,|卡号3,密码3,必填,双方协商的对称加密,使用3DES加密,合作方不能保存记录卡密)(必填)
card_amt
string
卡的总金额,单位:
元,当前寄售卡的总额(必填)
client_ip
string
用户来源IP(必填)
notify_url
string
单据处理后用来通知商户的地址(可选),URL参数是以http:
//开头的完整URL地址(后台处理)不填写则不通知,可通过查询接口确定单据状态
desc
string
简要说明(可选)
ext_param
string
商户自定义参数或扩展参数,接口按原值返回(可选)
time_stamp
string
提交时间戳(必填格式为yyyMMddHHmmss4位年+2位月+2位日+2位时+2位分+2位秒)(必填)
sign
string
数字签名(32位的md5加密,加密后转换成小写)
输出参数说明:
名称
类型
说明
ret_code
string
代码0表示成功,单据已被接收。
其他值参考4.8
ret_msg
string
返回消息
agent_id
string
商户ID号
bill_id
string
商户订单号
jnet_bill_no
string
成功后在汇元网产生的单据号
bill_status
string
单据状态:
0=未知;1=成功;-1=失败
card_real_amt
string
收到的卡的实际面值金额
card_settle_amt
string
卡的结算金额(如果当时返回0,可稍后隔天查看)
card_detail_data
string
卡明细信息,格式为卡号1,面值1,真实金额1|卡号2,面值,金额2|卡号3,面值3,金额3(当面值为空,请以真实金额为准)
ext_param
string
商户自定义参数或扩展参数
sign
string
数字签名的组成
ret_code=***&agent_id=***&bill_id=***&jnet_bill_no=***&bill_status=***&card_real_amt=***&card_settle_amt=***&card_detail_data=***|||md5Key
3.7.创建查询单的MD5签名
方法名称为:
MD5CreateSignForQuery,方法类型为bool类型,返回值为true时,sign的值为加密后的签名串,为false时,sign的值为具体的错误信息。
提交和返回的参数名均小写。
输入参数说明:
名称
类型
说明
agent_id
string
商家ID(必填)800j注册的账户数字ID
bill_id
string
商家提交的唯一订单号(必填)必须唯一6到50位
time_stamp
string
提交时间戳(必填格式为yyyMMddHHmmss4位年+2位月+2位日+2位时+2位分+2位秒)(必填)
md5Key
string
双方约定好的MD5加密秘钥(必填)
输出参数说明:
名称
类型
说明
sign
string
加密后的密文
3.8.查询单信息
方法名称为:
SubmitQueryInfo,方法类型为string类型,返回值为单提交后的响应信息。
提交和返回的参数名均小写。
接口输入参数说明:
名称
类型
说明
agent_id
string
商家ID(必填)800j注册的账户数字ID
bill_id
string
商家提交的唯一订单号(必填)必须唯一6到50位
time_stamp
string
提交时间戳(必填格式为yyyMMddHHmmss4位年+2位月+2位日+2位时+2位分+2位秒)(必填)
sign
string
数字签名(32位的md5加密,加密后转换成小写)
输出参数说明:
名称
类型
说明
ret_code
string
代码0表示成功,单据已被接收。
其他值参考4.8
ret_msg
string
返回消息
agent_id
string
商户ID号
bill_id
string
商户订单号
jnet_bill_no
string
成功后在汇元网产生的单据号
bill_status
string
单据状态:
0=未知;1=成功;-1=失败
card_real_amt
string
收到的卡的实际面值金额
card_settle_amt
string
卡的结算金额(如果当时返回0,可稍后隔天查看)
card_detail_data
string
卡明细信息,格式为卡号1,面值1,真实金额1|卡号2,面值,金额2|卡号3,面值3,金额3(当面值为空,请以真实金额为准)
ext_param
string
商户自定义参数或扩展参数
sign
string
数字签名的组成
ret_code=***&agent_id=***&bill_id=***&jnet_bill_no=***&bill_status=***&card_real_amt=***&card_settle_amt=***&card_detail_data=***|||md5Key
ret_code,bill_status详细说明请参考目录4.9
3.9.接口通知参数说明
当单据在汇元网平台已经被充值寄售后,系统自动调用合作商的通知接口(用户提供的notify_url参数),主动通知单据状态:
如:
http:
//******/receive.aspx?
ret_code=***&ret_msg=***&......$sign=***
例如:
http:
//******/Receive.aspx?
ret_code=0&ret_msg=成功&agent_id=123456&bill_id=20120220000227&jnet_bill_no=K1202270000689A0&bill_status=1&card_real_amt=10.00&card_settle_amt=8.50&card_detail_data=S250D0001490723,10.00,10.00&ext_param=&sign=********
参数信息说明:
名称
类型
说明
ret_code
string
代码0表示成功,单据已被接收。
其他值参考4.8
ret_msg
string
返回消息
agent_id
string
商户ID号
bill_id
string
商户订单号
jnet_bill_no
string
成功后在汇元网产生的单据号
bill_status
string
单据状态:
0=未知;1=成功;-1=失败
card_real_amt
string
收到的卡的实际面值金额
card_settle_amt
string
卡的结算金额(如果当时返回0,可稍后隔天查看)
card_detail_data
string
卡明细信息,格式为卡号1,面值1,真实金额1|卡号2,面值,金额2|卡号3,面值3,金额3(当面值为空,请以真实金额为准)
ext_param
string
商户自定义参数或扩展参数
sign
string
数字签名的组成
ret_code=***&agent_id=***&bill_id=***&jnet_bill_no=***&bill_status=***&card_real_amt=***&card_settle_amt=***&card_detail_data=***|||md5Key
返回说明:
每一笔支付订单支付完成后,汇元服务器会发送支付结果信息到商户接口程序,该程序根据订单的校验信息是否正确返回ok或者error字符串,(不能有其他任何输出(包括空格、空行))
3.10.返回代码值ret_code说明
ret_code的值代表的意义:
名称
说明
0
成功,对提交的数据以正常接收
-1
失败
-2
单据受理中
1
传入参数有误
2
代理商ID错误或未开通该服务
3
IP验证错误
4
签名验证错误
5
重复的订单号
6
卡加密错误
7
卡验证失败(具体可参考返回的ret_msg)
8
单据不存在
9
卡号或密码不正确
10
卡中余额不足
22
卡号卡密格式加密错误
98
接口维中
99
系统错误,未知(需要查询后在处理单据状态)
3.11.ret_code与bill_status
ret_code=0时,寄售单据才合法被接收:
bill_status=0时,寄售单据处理中,需要等待后再次查询
bill_status=1时,寄售单据已成功,被已结算,可查看结算金额
bill_status=-1时,寄售单据失败,由于各种原因此次申请失败,结算金额为0
ret_code=99时,单据未知,不确定单据是否失败,需要查询得到单据状态,对此状态的单据需谨慎处理
3.12.调用要求
1、合作方需要保证自定义的订单号不能重复。
2、合作方在条件允许的情况下,定期协商更换加密key,确保数据传输的安全性。
3、查询接口要与直充接口同时上线使用。
4、要求合作方能够保存明细帐,以便出错时进行对帐。
5、要求合作方对卡密不能保存记录,因此造成损失责任由合作方承担。
6、直充和查询接口的输入参数数字签名只针对必填参数。
4.常见问题
●问:
提示“商户ID错误或没有开通接口”?
答:
1、请检查当前商户id是否正确;
2、检查测试地址ip是否正确;
●问:
如何检查自己的程序是否正确?
答:
把请求的参数串组织好后,先直接在浏览器地址里请求,看返回的结果和自己程序返回的结果是否一致。
●问:
提示无效的卡类型?
答:
要保证提交的订单的卡类型与当前选择的卡类型一致;
●问:
提示无效的订单时间?
答:
请检查当前提交的订单时间的格式是否正确(格式为yyyMMddHHmmss4位年+2位月+2位日+2位时+2位分+2位秒);
5.附录
如果有任何问题,随时和我们联系。
电话:
010-82684945转806
QQ:
659018605(申请时请说明商家帐号和公司名称)
Email:
zljk@
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 文档 状态 草案 汇付