B2C网银支付商户端接口说明〔201104).doc

对B2C标准商户接口规约 通讯协议 目前网银系统支持三种方式与商户之间传递信息： 通过客户浏览器间接通讯： a. 商户引导客户浏览器，将信息提交到网银系统，商户系统发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。商户发送网上银行支付订单、商户发送手机银行支付订单、商户发送家居银行支付订单接口采用该方式通讯。表单数据中需包含商户对订单信息的签名。 b. 银行系统引导客户浏览器将信息提交到商户系统。银行反馈订单支付结果（页面通知）接口采用该通讯方式。表单信息中包含银行系统的签名数据。 商户操作员通过浏览器操作网银： 商户操作员登录网银操作网银功能，用来提交批量退货文件，下载批量退货反馈文件、业务对账文件与清算对账文件。（网银系统提供的其他商户操作员功能如订单查询等由于不涉及系统之间的接口规范，因此不再描述） 直接通讯： 商户系统与银行系统之间直接建立通讯链路，该通讯采用HTTPS协议。a. 由商户系统主动发起通讯，商户系统发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。商户查询订单信息、商户发送B2C退款指令接口采用此通讯方式。表单数据中需包含商户对交易信息的签名。 b. 由银行系统主动发起通讯，银行系统为保证商户收到订单支付处理结果，采用主动通知方式向商户发送B2C支付结果。银行网关发往商户系统的指令以POST方式发送，并且使用UTF8编码格式。银行系统向订单中接收通知的商户URL发送支付结果信息。通知信息中包含银行系统的签名数据。 接口报文 商户发送网上银行支付订单 接口名称： RecvOrder.do 接口说明： 客户在商户网站确认进行订单支付，选择中行网上银行支付后，商户系统负责按此数据规格将消费交易信息发往中行支付网关系统；商户主动发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。 数据项说明： 序号 名称 字段 最大长度 说明 商户号 merchantNo X(20) 必填BOC商户ID 支付类型 payType X(10) 必填商户支付服务类型 1：网上购物 商户订单号 orderNo X(19) 商户系统产生的订单号 订单币种 curCode X(3) 目前只支持001：人民币固定填001 订单金额 orderAmount X(13) 格式：整数位不前补零,小数位补齐2位即：不超过10位整数位+1位小数点+2位小数无效格式如123，.10，1.1,有效格式如1.00，0.10 订单时间 orderTime 9(14) 格式：YYYYMMDDHHMISS其中时间为24小时格式，例:2010年3月2日下午4点5分28秒表示为20100302160528 订单说明 orderNote X(200) 订单描述，，要求如果全中文最多允许60个汉字长度 商户接收通知URL orderUrl X(100) 客户支付完成后银行向商户发送支付结果，商户系统负责接收银行通知的URL 超时时间 orderTimeoutDate 9(14) 选填（一般商户无需上送，仅当商户需指定支付截止时间时上送。）YYYYMMDDHHMISS其中时间为24小时格式，例:2010年3月2日下午4点5分28秒表示为20100302160528。其含义为：如客户在该时间点仍未确认支付，则该笔支付将超时失败。 商户签名数据 signData X(4000) 必填商户签名数据串格式，各项数据用管道符分隔：商户订单号|订单时间|订单币种|订单金额|商户号orderNo|orderTime|curCode|orderAmount|merchantNo 接口示例：  商户发送手机银行支付订单 接口名称： B2CMobileRecvOrder.do 接口说明： 客户在商户手机WAP网站确认进行订单支付，选择中行手机银行支付后，商户系统负责按此数据规格将消费交易信息发往中行支付网关系统；商户主动发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。 数据项说明： 序号 名称 字段 最大长度 说明 商户号 merchantNo X(20) 必填BOC商户ID 支付类型 payType X(10) 必填商户支付服务类型 1：网上购物 商户订单号 orderNo X(19) 商户系统产生的订单号 订单币种 curCode X(3) 目前只支持001：人民币固定填001 订单金额 orderAmount X(13) 格式：整数位不前补零,小数位补齐2位即：不超过10位整数位+1位小数点+2位小数无效格式如123，.10，1.1,有效格式如1.00，0.10 订单时间 orderTime 9(14)