B2C网银支付商户端接口说明(201104)
- 格式：doc
- 大小：341.50 KB
- 文档页数：45
第1章对B2C标准商户接口规约1.1通讯协议目前网银系统支持三种方式与商户之间传递信息：通过客户浏览器间接通讯：a. 商户引导客户浏览器，将信息提交到网银系统，商户系统发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。
商户发送网上银行支付订单、商户发送手机银行支付订单、商户发送家居银行支付订单接口采用该方式通讯。
表单数据中需包含商户对订单信息的签名。
b. 银行系统引导客户浏览器将信息提交到商户系统。
银行反馈订单支付结果（页面通知）接口采用该通讯方式。
表单信息中包含银行系统的签名数据。
商户操作员通过浏览器操作网银：商户操作员登录网银操作网银功能，用来提交批量退货文件，下载批量退货反馈文件、业务对账文件与清算对账文件。
（网银系统提供的其他商户操作员功能如订单查询等由于不涉及系统之间的接口规范，因此不再描述） 直接通讯：商户系统与银行系统之间直接建立通讯链路，该通讯采用HTTPS协议。
a. 由商户系统主动发起通讯，商户系统发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。
商户查询订单信息、商户发送B2C退款指令接口采用此通讯方式。
表单数据中需包含商户对交易信息的签名。
b. 由银行系统主动发起通讯，银行系统为保证商户收到订单支付处理结果，采用主动通知方式向商户发送B2C支付结果。
银行网关发往商户系统的指令以POST方式发送，并且使用UTF8编码格式。
银行系统向订单中接收通知的商户URL发送支付结果信息。
通知信息中包含银行系统的签名数据。
1.2接口报文1.2.1商户发送网上银行支付订单接口名称：RecvOrder.do接口说明：客户在商户网站确认进行订单支付，选择中行网上银行支付后，商户系统负责按此数据规格将消费交易信息发往中行支付网关系统；商户主动发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。
数据项说明：接口示例：1.2.2商户发送手机银行支付订单接口名称：B2CMobileRecvOrder.do接口说明：客户在商户手机WAP网站确认进行订单支付，选择中行手机银行支付后，商户系统负责按此数据规格将消费交易信息发往中行支付网关系统；商户主动发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。
数据项说明：接口示例：1.2.3商户发送家居银行支付订单接口名称：HomeBankRecvOrder.do接口说明：客户在商户电视机顶盒系统界面确认进行订单支付，选择中行家居银行支付后，商户系统负责按此数据规格将消费交易信息发往中行支付网关系统；商户主动发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。
数据项说明：接口示例：1.2.4银行反馈订单支付结果(页面通知)接口说明：中行支付网关接收商户发来的网上银行支付订单、手机银行支付订单或家居银行支付订单后，引导客户进行支付确认，客户通过中行网银、手机银行或家居银行提交支付指令后，支付网关进行支付处理，处理完成后由网上银行支付结果页面、手机银行支付结果页面或家居银行支付结果页面向商户系统按以下数据规格反馈订单支付结果；指令均以POST方式发送，并且使用UTF8编码格式。
数据项说明：1.2.5银行发送B2C支付结果通知(主动通知)B2C订单支付失败的银行主动通知示例：1.2.6商户发送查询订单请求商户通过https指令向中行支付网关请求查询指定订单的支付情况。
商户系统需要参照以下数据规格构造https订单支付情况查询指令。
请求入口：CommonQueryOrder.do接口示例：中行以XML方式按照以下数据规格向商户系统进行反馈:接口示例：银行返回数据示例（返回订单信息）：<?xml version="1.0" encoding="utf-8" ?><res><header><msgId>0000204</msgId><hdlSts>A</hdlSts><bdFlg>0</bdFlg><rtnCd /></header><body><orderTrans><merchantNo>333555</merchantNo><orderNo>1225</orderNo><orderSeq>12851</orderSeq><orderStatus>0</orderStatus><cardTyp>1</cardTyp><acctNo>5555510100123456789</acctNo><holderName>张三</holderName><ibknum>07428</ibknum><payTime>20110624171313</payTime><payAmount>14.00</payAmount><visitorIp>127.0.0.1</visitorIp><visitorRefer /></orderTrans><orderTrans><merchantNo>333555</merchantNo>1.2.7商户发送B2C退款指令接口名称：RefundOrder.do接口说明：客户与商户协商退货后，商户系统对原来已经支付成功的订单（包括网上银行支付订单、手机银行支付订单、家居银行支付订单）进行退款时，商户系统采用HTTPS协议按此数据规格将B2C退款交易信息发往中行支付网关系统，银行完成退款处理后向商户实时反馈处理结果；商户主动发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。
数据项说明：商户按照以下数据规格向中行支付网关提交单笔B2C联机退款指令。
中行支付网关进行B2C退款处理完成后向商户系统按以下数据规格同步反馈退款处理结果（注意：处理状态为成功时一定存在包体数据记录退款交易信息；处理状态为失败时有两种情况，一种是无包体数据表示商户提交的数据校验不通过；另一种是有包体数据表示银行后台系统因为卡状态异常等原因进行退款处理失败）。
接口示例：商户上送数据示例：银行返回数据示例（退款处理成功）：<res><header><merchantNo>104110041000000</merchantNo><returnActFlag>3</returnActFlag><dealStatus>0</dealStatus><bodyFlag>0</bodyFlag><exception></exception></header><body><orderTrans><mRefundSeq>r0001</mRefundSeq><curCode>001</curCode><refundAmount>180.00</refundAmount><orderNo>324322</orderNo><orderSeq>1231</orderSeq><orderAmount>200.12</orderAmount><bankTranSeq>2010010111111111123456</bankTranSeq><tranTime>20090605000000</tranTime><signData>MIIEZgYJKoZIhvcNAQcCoIIEVzCCBFMCAQMxCTAHBgUrDgMCGjALBgkqhkiG9w0BBwGgggMdMIIDGTCCAgGgAwIB AgIQIbAY5mFnk0lHZcajtcSdEzANBgkqhkiG9w0BAQUFADBdMQswCQYDVQQGEwJDTjEWMBQGA1UEChMNQkFOSyBPRiBDSElOQTEQM A4GA1UECBMHQkVJSklORzEQMA43pV58B8IM=</signData></orderTrans></body></res>银行返回数据示例（退款处理失败）：1.2.8批量退货及反馈文件格式商户提供的批量退货文件：示例文件：B2C批量退货文件.txt银行提供的批量退货反馈文件：示例文件：B2C退货反馈文件.txt 格式说明：1.2.9业务对账文件格式银行提供的订单业务对账文件：示例文件：B2C业务对账文件.txt格式说明：银行卡类别X(2)银行卡类别（卡系统返回）01：中行借记卡02：中行信用卡，信用卡（分行卡）04：中行信用卡，信用卡（总行卡）11：银联借记卡21：VISA借记卡22：VISA信用卡31：MC 借记卡32：MC 信用卡42：运通卡52：大来卡62：JCB卡银行订单流水号9(20)银行的订单流水号（银行产生的订单唯一标识）订单状态X(2)订单的处理状态0：未处理1：支付2：撤销3：退货4：未明5：失败[记录循环结束]1.2.10清算对账文件格式示例文件：B2C清算对账文件.txt格式说明：文件清算对账文件说明中行支付网关T日提供的商户清算对账文件，记录网关T-1日接收清算系统账务清算处理的交易，包括支付及退货交易，如果为商户开通了跨行收单服务，则清算对账文件包括本行交易和跨行交易，其中为本行交易和跨行交易各出一个清算对账文件。
1．文件格式为TXT文本文件2．文件内容每行必须符合标准格式，且每行必须以回车换行结束3．文件第一行为交易合计信息：消费笔数|退货笔数|总计笔数|消费总金额|退货总金额|金额合计|4．数据项之间必须以管道符“|”分隔5．如数据项为空时，则相应的数据项不需填任何信息（包括空格）6．标准格式：商户号|订单号|协议号|终端号|交易日期时间|交易币种|交易金额|卡别|交易码|保留域|交易日期时间9(14)交易日期时间格式：YYYYMMDDHHMISS交易币种X(3)目前只支持人民币固定为001：人民币交易金额X(13)消费交易指支付金额；退货交易只退款金额；10位整数位+1位小数点+2位小数位支付卡卡别X(4)银行卡所属卡组织类别AMEX：美运BOCC/BOCD/BOCI/BOCQ：中行卡CUPC：银联卡DINC：大莱卡JCB：JCB卡MCCR：万事达卡VISA：维萨卡交易码X(4)交易类型PCEP：消费RVRP：消费撤销REFP：退货（包括批量退货）RVRP：退货撤销PUNC：跨行支付交易RUNC：跨行退货交易保留域X(86)1.3安全机制1.3.1安全机制简介商户与支付网关之间的通讯采用HTTPS协议，SSL握手时验证支付网关服务器证书，加密算法要求128位以上。
