文档状态草案汇付宝Word格式.docx
- 文档编号:20269485
- 上传时间:2023-01-21
- 格式:DOCX
- 页数:15
- 大小:146.23KB
文档状态草案汇付宝Word格式.docx
《文档状态草案汇付宝Word格式.docx》由会员分享,可在线阅读,更多相关《文档状态草案汇付宝Word格式.docx(15页珍藏版)》请在冰豆网上搜索。
选择点卡寄售注册
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
加密的秘钥。
输出参数说明:
triple_des_encrypt
加密后的密文。
3.4.3DES解密
Decrypt3DES,方法类型为bool类型,返回值为true时,triple_des_decrypt输出的是解密串,为false时,triple_des_decrypt输出的是错误信息。
要解密的字符串信息。
解密的秘钥。
triple_des_decrypt
解密后的原文。
3.5.创建支付单的MD5签名
MD5CreateSignForPay,方法类型为bool类型,返回值为true时,sign的值为加密后的签名串,为false时,sign的值为具体的错误信息。
提交和返回的参数名均小写。
输入参数说明:
agent_id
商家ID(必填)800j注册的账户数字ID
bill_id
商家提交的唯一订单号(必填)必须唯一6到50位
bill_time
商户订单时间(必填格式为yyyMMddHHmmss4位年+2位月+2位日+2位时+2位分+2位秒)
card_data
最多支持3张,格式为:
卡号1,密码1,|卡号2,密码2,|卡号3,密码3,必填,双方协商的对称加密,使用3DES加密,合作方不能保存记录卡密)(必填)
card_amt
卡的总金额,单位:
元,当前寄售卡的总额(必填)
notify_url
单据处理后用来通知商户的地址(可选),URL参数是以http:
//开头的完整URL地址(后台处理)不填写则不通知,可通过查询接口确定单据状态
time_stamp
提交时间戳(必填格式为yyyMMddHHmmss4位年+2位月+2位日+2位时+2位分+2位秒)(必填)
md5Key
双方约定好的MD5加密秘钥(必填)
sign
加密后的密文
3.6.支付单提交
SubmitOrderInfo,方法类型为string类型,返回值为单提交后的响应信息。
client_ip
用户来源IP(必填)
desc
简要说明(可选)
ext_param
商户自定义参数或扩展参数,接口按原值返回(可选)
数字签名(32位的md5加密,加密后转换成小写)
ret_code
代码0表示成功,单据已被接收。
其他值参考4.8
ret_msg
返回消息
商户ID号
商户订单号
jnet_bill_no
成功后在汇元网产生的单据号
bill_status
单据状态:
0=未知;
1=成功;
-1=失败
card_real_amt
收到的卡的实际面值金额
card_settle_amt
卡的结算金额(如果当时返回0,可稍后隔天查看)
card_detail_data
卡明细信息,格式为卡号1,面值1,真实金额1|卡号2,面值,金额2|卡号3,面值3,金额3(当面值为空,请以真实金额为准)
商户自定义参数或扩展参数
数字签名的组成
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的值为具体的错误信息。
3.8.查询单信息
SubmitQueryInfo,方法类型为string类型,返回值为单提交后的响应信息。
接口输入参数说明:
ret_code,bill_status详细说明请参考目录4.9
3.9.接口通知参数说明
当单据在汇元网平台已经被充值寄售后,系统自动调用合作商的通知接口(用户提供的notify_url参数),主动通知单据状态:
如:
http:
//******/receive.aspx?
ret_msg=***&
......$sign=***
例如:
//******/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=********
参数信息说明:
返回说明:
每一笔支付订单支付完成后,汇元服务器会发送支付结果信息到商户接口程序,该程序根据订单的校验信息是否正确返回ok或者error字符串,(不能有其他任何输出(包括空格、空行))
3.10.返回代码值ret_code说明
ret_code的值代表的意义:
成功,对提交的数据以正常接收
-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文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 文档 状态 草案 汇付
![提示](https://static.bdocx.com/images/bang_tan.gif)