快钱快钱网上支付

快钱分账收款与退款网关自助接入文档版本(v2.
0.
1)快钱支付清算信息有限公司目录1文档说明31.
1文档使用对象31.
2文档使用说明32快钱分账网关简介32.
1相关流程介绍32.
2.
1.
分账支付流程32.
2.
1.
分账支付流程42.
2快钱支付环境53快钱测试环境联调步骤53.
1.
请求提交到快钱53.
1.
1.
分账支付请求到快钱53.
1.
2.
分账退款请求到快钱63.
2支付结果返回给商户74快钱生产环境联调步骤84.
1证书生成84.
1.
1.
证书生成软件安装84.
1.
2.
证书生成84.
2.
证书上传下载124.
3.
修改快钱源代码134.
4.
分账支付请求提交到快钱144.
5.
支付结果返回给商户154.
6.
通知快钱技术检验155常见问题解答165.
1.
提交到快钱问题165.
2.
返回到商户问题165.
3.
证书相关问题166186.
1.
测试用例186.
2.
测试流程186.
2.
1.
分账收款测试流程186.
2.
2.
分账退款测试流程206.
3.
快钱验收流程206.
3.
1.
分账收款网关验收流程206.
3.
1.
分账退款网关验收流程21文档说明1.
1文档使用对象该文档主要面向商户技术和快钱技术支持.
商户技术可以通过该文档的指导,自主完成快钱分账网关测试环境和生产环境的联调;快钱技术支持必须熟悉该文档,特别在验收阶段,需要按照的验收流程做验收.

1.
2文档使用说明商户技术首先阅读第二章,熟悉分账网关的流程和联调环境.
从第三章开始,详细的介绍了商户在快钱测试环境的联调流程和步骤,经过测试环境的联调,商户将更加深入的了解分账网关的支付和退款流程.
第四章介绍商户如何从快钱测试环境切换到生产环境,本章分别从安装生成证书软件、证书生成以及代码的修改各个方面做了详细的介绍.
经过生产环境的测试,商户将完全掌握快钱分账网关的接入流程.
第五章主要列出商户经常碰到的问题并做详细的解答,该部分内容供商户接入过程中参考.
最后一章介绍了分账网关的测试用例和测试流程以及快钱技术支持的验收标准,商户需要根据这些用例进行测试,同时快钱技术支持需要按照的检验流程进行验收.

快钱分账网关简介2.
1相关流程介绍分账收款与退款的流程描述.
2.
2.
1.
分账支付流程流程详解:1、消费者选择商品,商品参数传递给send页面.
2、Send页面将请求提交到快钱.
3、Send提交后,跳转到快钱银行列表页面,快钱测试环境的银行是模拟的银行,支付不需要用真实银行卡做测试.
4、支付完毕后,快钱会将支付结果反馈给receive页面,该功能在send页面中的bgUrl参数设置的,该地址要求是外网能访问到的地址,不能是localhost地址,商户技术可以参考send页面所给的例子.

5、receive页面接收到快钱支付结果后,商户先做业务逻辑处理,比如更新数据库.
之后再通知快钱已经接收到支付结果.
通知快钱接收到支付结果的功能由标签实现,该标签的值一定要为1,表示商户接收到通知.
如果该值不为1,快钱会不停的向该receive页面发送支付结果,所以要求商户只要接收到快钱的支付结果,不管交易结果是成功还是失败,的值都要返回1.
6、receive页面接收到快钱支付结果后,会自动将参数传递给show页面并跳转到show页面,该功能是由receive页面中的标签实现,该标签中的值便是show页面的地址.
代码中的标签已经赋值,商户需要根据自己的实际情况做修改.
同样,show页面不能是localhost的本地地址.

2.
2.
1.
分账退款流程流程详解:1、消费者找到支付订单,选择退货以后,商品参数传递给send页面.
2、Send页面将请求提交到快钱.
3、Send提交后,快钱将退款信息以XML报文的形式返回给商户,商户需要自行解析XML,得到正确的result节点.
2.
2快钱支付环境快钱提供两套环境,一套是测试环境,另一套是生产环境.
一般建议商户先在快钱的测试环境做测试,熟悉快钱的分账网关之后再迁移到生产环境做测试.
如果商户熟悉快钱的分账网关接口和流程,可以直接在快钱的生产环境做测试.

快钱测试环境联调步骤3.
1.
请求提交到快钱测试联调页面显示3.
1.
1.
分账支付请求到快钱1、商户技术选择快钱开发包,打开send页面代码,send页面代码对每个参数做了非常详细的注释,商户需要先了解这些参数的意义.
另外,商户需要特别注意以下两个参数:A、pid:代表分账网关平台账号,商户看到的分账网关平台账号是快钱提供给商户在测试环境做测试的账号.
商户迁移到快钱生产环境测试时,需要将该参数修改为自己的平台号,详情请看生产环境部分.

B、bgUrl:代表商户接收地址,代码中的值是快钱提供的例子,该地址用于接收支付结果,消费者支付后,快钱会第一时间将支付结果反馈到该地址.
该参数需要商户修改成自己的receive接收页面地址,而且该地址必须保证是外网能访问到的,不能是localhost的地址.

理解send页面中的参数后,商户可以开始运行快钱代码,在浏览器打开send页面,显示如下:2、提交到快钱后,如果能正常出现以下页面,证明商户在快钱测试环境的提交测试是成功的.
3、提交后,跳转到以下模拟银行页面,如果显示不是以下页面,请联系快钱技术支持,商户切记不要用自己真实的银行卡在此处做测试.
3.
1.
2.
分账退款请求到快钱1、商户技术选择快钱开发包,打开send页面代码,send页面代码对每个参数做了非常详细的注释,商户需要先了解这些参数的意义.
另外,商户需要特别注意以下两个参数:A、seqId:代表分账退款生成的退款订单号,这里需要注意的是:商户在提交到快钱网关时应该避免此参数不能同时重复提交,否则会出现,20036:退款防并发.
B、shareRefundFeeFlag:代表退手续费标志,默认不填或者值为0.
如果分账收款的主收款方不参与退款,想退款成功,就把此参数值设置为1,意思为快钱不退手续费.
这里需注意:退款明细中必须写上的主收款方账户以及退款金额为0.

理解send页面中的参数后,商户可以开始运行快钱代码,在浏览器打开send页面,显示如下:2、提交到快钱以后,返回的是个XML报文,需要商户自行根据XML节点去解析,这里就不一一解析了,注意参数:result=10,只是代表了分账退款申请成功,并不是已经退款成功,正常情况下,退款一般需要(5-7个工作日)可以退到支付人账户.
这里需要强调的是退款返回的申请成功报文是实时返回的,但是有时候因为双方网络异常会导致商户端未及时收到返回信息亦或者返回了错误的报文,请商户使用"分账退款查询"接口,先确定此笔异常订单是否到快钱已落地如果查询已经是申请成功的状态,请不要重复发起退款请求,避免造成重复退款.

3.
2支付结果返回给商户1、按"二次通知支付"后,出现以下返回页面.
商户如果能正常运行到这一步,证明商户在快钱测试环境的整个测试是成功的.
快钱生产环境联调步骤分账收款与退款网关均需要使用证书加密.
4.
1证书生成从快钱的java和c#代码包中,可以看到两个证书,其中证书用于send页面对提交的参数组成串后的签名,主要作用是防止商户提交的数据传输过程中被篡改.
证书用于receive页面中对快钱返回的参数进行验签,主要作用是验证快钱返回给商户的参数没有被篡改.

需要强调一下,php与java、c#不同,用到的证书是,其中的作用于java、c#一样.
而相当于java、c#中的,两个证书内容相同,作用一样,只是格式不一样而已.
快钱开发包里面提供的证书是针对测试环境的,商户要在生产环境联调,需要自己生成证书.
商户按照以下流程生成证书即可.

4.
1.
1.
证书生成软件安装点击快钱开发包里面提供的Win32OpenSSL_Light-0_9_8k.
exe安装软件,一直点next即可完成软件的安装,该软件用于生成证书.
软件只要安装在商户技术本地电脑即可.

4.
1.
2.
证书生成1、如下图,打开openssL.
exe2、输入genrsa-outprivate-rsa.
key1024,按enter即可.
3、输入req-new-x509-keyprivate-rsa.
key-days750-outpublic-rsa.
cer,按enter,然后按照第二个图片提示进行填写.
4、输入pkcs12-export-nametest-alias-inpublic-rsa.
cer-inkeyprivate-rsa.
key-out99bill-rsa.
pfx,按enter,然后按照第二个图输入密码,密码输入时不会显示出来.
商户必须记住该密码,在代码中需要用到.
5、如下,进入openssl的bin目录,可以看到执行以上命令后生成的两个证书.
6、如果是使用PHP的商户,需要将"99bill-rsa.
pfx"证书转换为"99bill-rsa.
pem",输入转换命令pkcs12-in99bill-rsa.
pfx-passinpass:此处输入商户第4步设置的密码-nodes-out99bill-rsa.
pem,按enter即可.
进入openssl的bin目录,此时可以看到pem格式证书已经生成.
4.
2.
证书上传下载1、上传证书,登陆www.
99bill.
com,账号和密码请找商户管理快钱账号的人员要,一般是商户的财务.
a、分账收款网关,选择产品或功能,请选择:分账支付网关(人民币账户)b、分账退款网关,选择产品或功能,请选择:分账网关退款(人民币账户)2、证书下载,按照下图进行RSA证书下载,这里下载的是快钱公钥证书,无论是分账收款还是退款都用此证书进行返回验签.
4.
3.
修改快钱源代码1、修改send页面的pid,pid为平台方在快钱申请的唯一编号.
商户的快钱用户编号请登录www.
99bill.
com获得,具体如下2、修改send页面中form表单的提交地址,将sandbox改为www.
修改后的地址为如下地址:https://www.
99bill.
com/msgateway/recvMsgatewayMerchantInfoAction.
htm3、商户技术将自己生成的私钥证书(java、c#为99bill-rsa.
pfx,php为99bill-rsa.
pem)和从快钱端下载下来一共两个证书放到项目中,替换原来测试环境的证书,注意一下证书密码也需要跟私钥证书对应上,否则报错.

4、修改send中调用私钥证书的地方为刚替换的证书(java、c#为99bill-rsa.
pfx,php为99bill-rsa.
pem),密码修改为商户生成证书时设置的密码.
5、修改receive中调用快钱公钥的地方为新下载的快钱公钥.
4.
4.
分账支付请求提交到快钱1、商户可以开始运行快钱代码,在浏览器打开send页面,订单金额统一用50分钱即可,显示如下:2、提交到快钱后,如果能正常出现以下页面,证明商户在快钱生产环境的提交测试是成功的.
3、提交后,页面会跳转到真实的银行端,此时需要商户用自己真实的银行卡进行支付.
4.
5.
支付结果返回给商户1、支付完毕后,在银行端按"返回商场",即可跳到以下页面.
商户如果能正常运行到这一步,证明商户在快钱正式环境的测试是成功的.
4.
6.
通知快钱技术检验完成以上测试后,商户在快钱测试环境和正式环境的联调已经顺利通过,但商户必须通知快钱技术支持进行最终检查.
快钱技术支持的检查项目请参照《验收流程》部分进行验收.
常见问题解答5.
1.
提交到快钱问题Q:错误代码:10025,错误信息:商户未开通分账网关.
A:出现这个错误是因为商户号未开通分账网关,请直接联系负责的销售等前端同事,要求开通分账相关配置即可.
Q:错误代码:4005,错误信息:主收款方账户不正确A:出现这种问题的商户是由于商户提交的参数:payeeContact对应的email账户未在快钱注册验证,还不具备收款功能,需联系负责的前端同事帮忙验证.
Q:错误代码:4001,错误信息:商户地址不允许进行分账操作.
A:出现此问题的商户一般是绑定了商户服务器ip,但是提交请求的当前ip与之不符,导致出现此问题,需联系销售或负责的前端同事帮忙确认并且新增ip即可.
5.
2.
返回到商户问题Q:分账收款接口,receive页面进行签名时出现验签不一致A:检查返回验签所调用的公钥是否为在快钱后台下载的RSA类型的证书.
检查把返回参数组成签名字符串是否有问题,顺序是否一致,参数名是否都正确,参考DEMO.
5.
3.
证书相关问题Q:商户的证书有效期是多长时间A:一般按照我们的生成命令去生成商户的公私钥的时候,证书的有效期是750天Q:一个商户有多个快钱帐户,证书是否可以用相同的A:可以.
证书是与商户号关联的.
但是出于安全性考虑,不建议商户将所有账户都全部使用统一的证书.
Q:我在生成证书第三步的时候,无法"EnterExportPassword",这是什么原因呢A:这里输入密码是不会显示出来的,但输入都是有效的,请商户记住自己输入的密码.
Q:关于PHP服务器上报不支持openssl_pkcs12_readA:PKI加密方式PHP不支持openssl_pkcs12_read这个函数,openssl_pkcs12_read这个函数只有PHP5.
2版本以上才支持,所以先要升级到PHP5.
2,如果服务器是windowsIIS,在windows系统中IIS环境的操作方式:1、在c:\windows\php.
ini中将;extension=php_openssl.
dll前面分号(注释)去掉2、复制php安装目录中的:libeay32.
dll、ssleay32.
dll至c:\windows\system323、复制PHP\ext目录中的php_openssl.
dll至c:\windows\system324、重启IISQ:上传证书的时候报:证书校验异常:上传证书的失效日期应该晚于XXXX-XX-XX日,请重新上传证书A:一般是因为之前已经上传过证书,可将之前上传过的证书进行挂失操作,然后再上传.
方法:http://www.
99bill.
com登录快钱,安全设置-商户证书-状态查询与挂失,在对应的产品证书申请挂失.
6.
1.
测试用例NO.
测试用例输入预期效果1网关提交(带中文参数)1、商品名称为中文名称;2、用一定金额做测试1、到达快钱支付页面;2、商品名称不出现乱码.
2网关返回(网银测试)1、提交模拟银行支付订单1、能够通过模拟网银进行正常支付;3网关返回(快钱账号测试)1、采用快钱账号支付1、能够通过快钱账号进行正常支付4bgUrl参数监控1、快钱技术支持根据商户测试的订单号,在query后台查询提交的bgUrl参数是否正确.
1、正常5返回标签监控1、快钱技术支持根据商户测试的交易号,在query后台查询是否返回快钱要求的标签1、正常6.
2.
测试流程6.
2.
1.
分账收款测试流程提交到快钱,商户提交金额设定为"50"分钱,如下:提交后,到快钱选择银行页面,证明提交成功.
选择银行支持,出现一下模拟银行提交后,快钱返回到商户,证明返回正常.
6.
2.
2.
分账退款测试流程1、提交到快钱,截图如下:1、快钱实时返回XML信息,截图如下,证明返回正常.
6.
3.
快钱验收流程6.
3.
1.
分账收款网关验收流程1、快钱技术支持在query后台检查商户提交bgUrl,一般pageUrl要求为空.
如下2、快钱技术支持在query后台检查商户返回快钱标签.
注意:商户网站上线前需将测试交易发送与技术支持验证,直到出现下面日志,方可上线正常使用,否则交易出现的任何异常情况均由商户自行承担.