EasyPay虚拟支付设计方案（初稿）

1、EasyPay虚拟支付 第 PAGE 20页，共 NUMPAGES 20页EasyPay虚拟支付设计方案（初稿）版本：1.0作者： 建立日期：上次修改日期:文 档 控 制修改记录日 期作 者版 本修 改 内 容审阅人姓 名职 位虚拟支付主要功能设计：虚拟账户管理控制针对每一个orgid可建立一套虚拟支付的账号，账号可由订票网站指定提供，或由EasyPay自行建立，账号要求在orgid对应的订票网站不重复一个accountno有一个支付密码，支付密码在消费时使用。可设置orgid的管理员usrid，对accountno进行管理，可对指定accountno充值和授信、授信延期、手工扣减额度、管理（

2、充值和授信）密码修改操作一个accountno只能对一种币种进行充值和消费accountno的初始额度为可根据orgid、accountno分别设定充值、授信、消费、退款功能的权限账户内对应的总额实时变动规则：现金充值增加总额后台授信增加总额购票支付时减少总额手工直接扣减总额操作后减少授信额度到期后扣减总额退款后增加总额禁用状态下不允许进行任何操作现金充值提供直接将金额充值到指定账号的接口，充值后总额进行调整。授信充值，授信有效期提供授信充值，到授信有效期当日：，系统自动进行计算，账户总额授信额，如果结果为负，即总额不够扣减授信，则关闭支付功能，不允许进行支付，直到账户再次现金支付或授信充值，

3、额度为正以后方可进行支付。授信支付未到期前允许延期操作。退款用虚拟支付的进行的支付交易退款，不实际退钱，将票款增加到账户总额中，可再次使用即可。退款可实现多次退，部分和全部退款。维护进程查询：消费接口查询，充值查询提供单笔、批量查询接口，可查询充值交易、授信交易、支付交易、退款交易的详细信息。虚拟支付接口说明：请求方式为https请求的参数为Orgid,Apptype,ServiceType,Version,RequestXML,Signature返回的参数为ResponseXML，Signature根据接口功能的不同，RequestXML，ResponseXML对应不同的xml文本交易数据发

4、送和返回都带签名，请求和返回均采用easypay提供的密钥进行签名验证。实现如下接口：现金充值，授信充值消费支付 退款账户注册、修改单笔查询批量查询授信支付延期5、测试系统请求地址： HYPERLINK /easypay/vpay.do?%22+data /easypay/vpay.do6、调用方式 A、页面post方式 B、HttpClient方式如果用此方式，需要将referer置成 HYPERLINK /easypay /easypay虚拟支付接口定义：请求的参数调用为：参数名称注释用例Orgid用户的ORGIDHUAIRNEWApptype用户的APPTYPEB2CServiceTyp

5、e接口名称：VIRTUALPAYVersion版本号1.0RequestXML请求的数据XML Signature签名数据。签名方式与网站普通支付方式相同，通常为MD5 不论是用哪种方式，签名的原始数据为Orgid +”&”+Apptype +”&”+ServiceType +”&”+Version+”&”+RequestXMLrequestXML定义在文档中依功能不同逐一说明返回客票网站的参数为：参数名称注释用例ResponseXML请求的数据XML Signature签名数据。签名方式为RSA，与网站普通支付返回方式相同 不论是用哪种方式，签名的原始数据为ResponseXMLrespon

6、seXML定义在文档中依功能不同逐一说明详细功能说明：现金充值，授信充值请求requestXML信息域注释用例EasyPayMessageversion版本号1.0txntype充值CASH/CREDITTxnCashCreditContent交易信息txnid充值ID充值交易号，客票网站保障唯一即可txntime充值时间格式：yyyymmddHIMMSS例如：20100801020101accountno账户NOtxnamount充值金额 0的数pin充值密码充值密码需要做3des加密 currency币种币种三字码usrid充值操作人creditenddate授信截止日期txntype为C

7、ASH不用填 fatheraccount父账户NO无父账户可为空 opertype操作类别A: 充值、授信S:扣减充值，扣减授信vpayreturntype数据返回类别0:无返回，结果直接输出到response中，客票网站可直接获取。1:返回数据发送到指定returnid指定的url中vpayreturnid配置返回的return_idvpayreturntype=1的时候必须填写，否则可为空 ext1预留字段充值：1.0CASH20100823000120100823140101VMF00000781000.00888888RMBtestA0 授信：1.0CREDIT201008030003

8、20100820140101VMF00000781000.00123456RMBtest20100830A0 返回结果responseXML:信息域注释用例EasyPayMessageversion版本号1.0RetMsgContent交易返回代码信息retCode返回码retMessage返回信息TxnCashCreditContenttxntype充值CASH/CREDITtxnid充值ID充值交易号txntime充值时间txnamount充值金额 status状态1:充值、授信成功0:失败curr_accu_amount 账号余额消费支付请求信息域注释用例EasyPayMessageve

9、rsion版本号1.0txntype支付交易PAYTxnPayContent交易信息txnid支付ID支付交易号，客票网站保障唯一即可txntime支付时间格式：yyyymmddHIMMSSaccountno账户NOtxnamount支付金额 0的数pin支付密码支付密码需要做3des加密 currency币种币种三字码usrid支付操作人 opertype操作类别缺省0:不对父账户扣减总额：扣减子账户同时扣减父账户总额vpayreturntype数据返回类别0:无返回，结果直接输出到response中，客票网站可直接获取。1:返回数据发送到指定returnid指定的url中vpayretur

10、nid配置返回的return_idvpayreturntype的时候必须填写，否则可为空 lan语言CNext1预留字段消费 1.0PAY20100820000120100820140101VMF000007810.00888888RMBtest00CN响应信息域注释用例EasyPayMessageversion版本号1.0RetMsgContent交易返回代码信息retCode返回码retMessage返回信息TxnPayContenttxnid支付ID支付交易号txntime支付时间格式：yyyymmddHIMMSStxnamount支付金额 status状态1:支付成功0:失败curr_

11、accu_amount 账号余额退款、请求信息域注释用例EasyPayMessageversion版本号1.0txntype交易类型：退款REFUNDTxnRefundContent交易信息accountno虚拟账户NOVMF0000083orderno退款订单对应的电子客票编号退款订单对应的电子客票编号bankid支付银行VPAYtxnid支付ID需退款的支付编号refundid退款流水编号与网站记录一致，客票网站保障唯一即可 currency币种币种三字码refundamount退款金额101.6txntime退款提交时间格式：yyyymmddHIMMSSusrid退款请求提交人testu

12、srvpayreturntype数据返回类别0:无返回，结果直接输出到response中，客票网站可直接获取。1:返回数据发送到指定returnid指定的url中vpayreturnid配置返回的return_idvpayreturntype=1的时候必须填写，否则可为空 ext1预留字段示例：1.0REFUNDVMF0000083123456789001VPAY30000012320012010082000008RMB101.6testrefund201008201057200、响应信息域注释用例EasyPayMessageversion版本号1.0txntype交易类型REFUNDRetM

13、sgContent交易返回代码信息retCode返回码00000retMessage错误信息操作成功TxnRefundContenttxnid支付ID支付交易号(与请求一致)refundid退款流水编号退款交易号(与请求一致)refundtime退款时间格式：yyyymmddHIMMSSrefundamount退款金额 101.6refundstatus状态与退款表中的状态一致：0退款申请中1等待退款2退款成功 3 退款失败curr_accu_amount虚拟账号退款后的当前余额1538.8示例：1.0 REFUND 00000操作成功30000012320012010082000008201

14、00820105729101.621538.8虚拟账号注册、请求信息域注释用例EasyPayMessageversion版本号1.0txntype交易类型：注册账号REGISTACCOUNTTxnRegsitContent交易信息accountno账号（主键）如果为空则Easypay系统自动生成password_pay支付密码123456accu_amount账号余额0.0currency币种RMBpwdexp密码提示问题pwdexpans密码提示问题答案creatdate账号开通时间格式：yyyymmddHIMMSSusrid账号开通操作人teststatus账号状态（是否可用）1开通0禁用

15、 2销户limit账号权限（四位数字分别代表充值、授信、消费、退款权限，1代表有权限0代表没有，比如1111，0000）1111sub_account_sign子账户标志，不能为空 Y：子账号 N：非子账号father_account父账户sub_account_aign=Y时不能为空vpayreturntype数据返回类别0:无返回，结果直接输出到response中，客票网站可直接获取。1:返回数据发送到指定returnid指定的url中vpayreturnid配置返回的return_idvpayreturntype=1的时候必须填写，否则可为空 示例：1.0REGISTACCOUNT100

16、0123456whatquestionmyanswerRMBtest2010082011281611111N0、响应信息域注释用例EasyPayMessageversion版本号1.0txntype交易类型：注册账号REGISTACCOUNTRetMsgContent交易返回代码信息retCode返回码00000retMessage错误信息操作成功TxnRegsitContentaccountno账号（主键）VMF0000084orgid应用标识MFOSB2Bstatus开通、禁用、销户1开通0禁用2销户示例：1.0 REGISTACCOUNT 00000操作成功VMF0000084MFOSB

17、2B1修改支付密码1、请求信息域注释用例EasyPayMessageversion版本号1.0txntype修改支付密码CHANGEPAYPWDTxnChangPayPwdContent交易信息accountno账号（主键）oldpassword_pay旧支付密码newpassword_pay新支付密码newpwdexp新密码提示问题newpwdexpans新密码提示问题答案usrid密码修改人operatetime密码修改时间格式：yyyymmddHIMMSSvpayreturntype数据返回类别0:无返回，结果直接输出到response中，客票网站可直接获取。1:返回数据发送到指定ret

18、urnid指定的url中vpayreturnid配置返回的return_idvpayreturntype=1的时候必须填写，否则可为空 示例：1.0CHANGEPAYPWDVMF0000084123456888888newquestionnewanswerchangeuser2010082013235202、响应信息域注释用例EasyPayMessageversion版本号1.0txntype修改支付密码CHANGEPAYPWDRetMsgContent交易返回代码信息retCode返回码retMessage错误信息TxnChangPayPwdContentaccountno账号（主键）org

19、id应用标识status帐号状态开通、禁用、销户示例：1.0CHANGEPAYPWD00000操作成功VMF0000084MFOSB2B1账户开通、禁用、销户1、请求信息域注释用例EasyPayMessageversion版本号1.0txntype操作类型OPENACCOUNT/DISABLEACCOUNT/CANCELACCOUNTTxnAccControlContent交易信息accountno账户NOuserid操作人IDvpayreturntype数据返回类别0:无返回，结果直接输出到response中，客票网站可直接获取。1:返回数据发送到指定returnid指定的url中vpayr

20、eturnid配置返回的return_idvpayreturntype=1的时候必须填写，否则可为空 2、响应信息域注释用例EasyPayMessageversion版本号1.0txntype操作类型OPENACCOUNT/DISABLEACCOUNT/CANCELACCOUNTRetMsgContent交易返回代码信息retCode返回码retMessage返回提示信息TxnAccControlContentaccountno帐号NOorgidorgidstatus帐号状态1-启用 0-禁用2-销户查询帐号信息请求信息域注释用例EasyPayMessageversion版本号1.0txnty

21、pe操作类型QUERYACCOUNTLISTTxnQueryAccListContent交易信息accountnolist账户列表11111，22222（多个帐号用“，”分隔）vpayreturntype数据返回类别0:无返回，结果直接输出到response中，客票网站可直接获取。1:返回数据发送到指定returnid指定的url中vpayreturnid配置返回的return_idvpayreturntype=1的时候必须填写，否则可为空 响应信息域注释用例EasyPayMessageversion版本号1.0txntype操作类型QUERYACCOUNTLISTRetMsgContent交

22、易返回代码信息retCode返回码retMessage返回提示信息TxnAccControlContentaccountnolist各个帐号信息以|分隔同一帐号的各项以,分隔每个帐号的返回向由下面5项组成accountno帐号accu_amount帐号当前余额（现金+授信）current_credit帐号当前授信额度status帐号当前状态1-启用 0-禁用2-销户currency币种查询接口单笔查询请求信息域注释用例EasyPayMessageversion版本号1.0TxnQueryContent交易信息txntype支付交易QUERYSINGLEaccountno账户NOtxnid支付I

23、D支付交易号refundid退款opertype操作类别CASH充值CREDIT授信PAY支付REFUND退款vpayreturntype数据返回类别：无返回，结果直接输出到response中，客票网站可直接获取。：返回数据发送到指定returnid指定的中vpayreturnid配置返回的return_idVpayreturntype的时候必须填写，否则可为空 响应信息域注释用例EasyPayMessageversion版本号1.0RetMsgContent交易返回代码信息retCode返回码retMessage错误信息TxnQueryContentaccountno账户NOtxnid支付I

24、D交易号refundid退款txntime支付时间格式：yyyymmddHIMMSStxnamount支付金额 accountno账户NO currency币种币种三字码usrid操作人creditenddate授信截止日期txntype为CASH不用填status状态opertype操作类别QCASH充值QCREDIT授信QPAY支付QREFUND退款省略了一些项，开发时再添加批量查询请求信息域注释用例EasyPayMessageversion版本号1.0BatchTxnQueryContent交易信息txntype支付交易QUERYBATCHfirstpageno当前页缺省为maxrec每

25、页返回最大记录数=100accountno账户NOtxnid支付ID支付交易号refundid退款opertype操作类别QCASH充值QCREDIT授信QPAY支付QREFUND退款status状态starttime查询结束时间格式：yyyymmddHIMMSSendtime查询结束时间格式：yyyymmddHIMMSSvpayreturntype数据返回类别：无返回，结果直接输出到response中，客票网站可直接获取。：返回数据发送到指定returnid指定的中vpayreturnid配置返回的return_idVpayreturntype的时候必须填写，否则可为空 5响应信息域注释用例

26、EasyPayMessageversion版本号1.0RetMsgContent交易返回代码信息retCode返回码retMessage错误信息BatchTxnQueryContent Txnlisttotal查询总记录数Txnlistcount返回记录数QueryContentaccountno账户NOtxnid支付ID交易号refundid退款txntime支付时间格式：yyyymmddHIMMSStxnamount支付金额 accountno账户NO currency币种币种三字码usrid操作人creditenddate授信截止日期txntype为CASH不用填status状态oper

27、type操作类别QCASH充值QCREDIT授信QPAY支付QREFUND退款省略了一些项，开发时再添加授信支付延期（未完成）附：错误代码列表00000操作成功 10001充值或授信txnid不能为空 10002充值或授信时间不能为空 10003充值或授信时间格式不对 10004充值或授信账户NO不能为空 10005充值或授信金额不能为空 10006充值或授信金额不能为零或负数 10007充值或授信pin不能为空 10008充值或授信币种不能为空 10009充值或授信操作人不能为空 10010充值或授信数据返回类别不能为空 10011充值或授信配置返回的return_id不能为空 10012充

28、值或授信币种与账户币种不一致 10013充值或授信无此账号 10014该txnid系统已做过充值，请勿重复充值 10015该txnid系统已做过授信，请勿重复授信 10016充值过程发生错误 10017充值或授信交易类型错误 10018授信记录写入错误 10019授信充值主账号错误 10020充值记录写入错误 10021CASH充值主账号错误 10022充值密码错误 10023充值商户名称错误 10024该用户无充值或授信操作权限 10025该商户无此充值用户 20001支付txnid不能为空 20002支付时间不能为空 20003支付时间格式不对 20004支付账户NO不能为空 20005支付金额不能为空 20006支付金额不能为零或负数 20007支付pin不能为空 20008支付币种不能为空 20009支付操作人不能为空 20010支付数据返回类别