中信银行网上支付接口

中信银行B2C网上支付平台订单接口说明书版本V1.2©2009中信银行版权所有文档编号保密等级作者B2C网上支付平台项目组最后修改日期审核人最后审批日期批准人最后批准日期中信银行信息技术部中信银行网上支付平台订单接口说明（版本V1.2）中信银行质量管理体系第II页修改记录日期版本作者/修改者描述审核人2009-7-11.0仇贺军新建模板。吴毓毅2010-9-171.1白靖宇增加防钓鱼措施：修改2.1及2.2中的订单接口报文与支付结果报文。扈浩2010-12-71.2.1扈浩针对山东省财政厅非税收入网上支付需求，修改直联商户订单接口报文中的摘要信息（MEMO）字段的最大长度为300（详见2.2.3）。扈浩2011-1-71.2.2扈浩修改接口报文中防钓鱼措施的相关说明。扈浩中信银行网上支付平台订单接口说明（版本V1.2）第III页目录一、概述...........................................................................................................................................................11.1文档用途.............................................................................................................................................11.2适用对象.............................................................................................................................................1二、订单接口...................................................................................................................................................12.1第三方支付商户订单接口.................................................................................................................12.1.1订单支付请求方式..................................................................................................................12.1.2订单接口报文..........................................................................................................................12.1.3订单接口说明..........................................................................................................................22.1.4支付结果返回方式..................................................................................................................42.1.5支付结果报文..........................................................................................................................52.1.6支付结果说明..........................................................................................................................62.2直联商户订单接口.............................................................................................................................72.2.1订单支付请求方式..................................................................................................................72.2.1订单接口报文..........................................................................................................................72.2.3订单接口说明..........................................................................................................................82.2.4支付结果返回方式................................................................................................................112.2.5支付结果报文........................................................................................................................112.2.6支付结果说明........................................................................................................................12中信银行网上支付平台订单接口说明（版本V1.2）第1页一、概述1.1文档用途此文档主要提供B2C网上支付平台订单信息接口说明，为第三方支付商户和直联商户接入中信银行B2C网上支付平台提供开发参考。1.2适用对象中信银行B2C网上支付平台商户的系统设计和开发人员。二、订单接口2.1第三方支付商户订单接口2.1.1订单支付请求方式订单采用FORM表单POST方式传送，其中ACTION地址为https://网上支付平台地址/pec/e3rdplaceorder.do，参数名为SIGNREQMSG。SIGNREQMSG参数值为BASE64编码的订单签名信息。其中网上支付平台地址：测试环境为ec.test.bank.ecitic.com生产环境为b2c.bank.ecitic.com2.1.2订单接口报文?xmlversion=1.0encoding=GBK?streamE3RDPAYNO110001/E3RDPAYNO!--第三方支付平台编号--ORDERMODE01/ORDERMODE!--订单支付模式--ORDERDATE2008-05-06/ORDERDATE!--订单日期--ORDERTIME09:01:02/ORDERTIME!--订单时间--ORDERNO2008050609000000001/ORDERNO!--订单号--CURRID01/CURRID!--订单支付币种--ORDERAMT7800.00/ORDERAMT!--订单金额--中信银行网上支付平台订单接口说明（版本V1.2）第2页MEMO充值支付/MEMO!--摘要--NOTIFYMODE01/NOTIFYMODE!--通知模式--NOTIFYURL!--商户通知-RISKLEVEL00/RISKLEVEL!--风险级别--SUPPTCARDTYPE00/SUPPTCARDTYPE!--支持卡种--TTL/TTL!--订单有效期--MEMBERID/MEMBERID!—订单人，可以是用户在商户网站的USERID--NOTIFYSCOPE/NOTIFYSCOPE!--支付结果通知范围--ISSAFEINF/ISSAFEINF!--是否进行防钓鱼控制--REFERER/REFERER!--商户信任域名列表--/stream2.1.3订单接口说明序号元素名称名称字段类型长度说明1E3RDPAYNO商户编号VARCHAR6此编号在银行开通B2C网上支付业务时提供。（必输项）2ORDERMODE订单模式VARCHAR201：直接支付02：冻结支付目前固定送01（必输项）3ORDERDATE订单日期DATE订单生成日期yyyy-mm-dd（必输项）4ORDERTIME订单时间TIME订单生成时间hh:mm:ss（必输项）5ORDERNO订单号VARCHAR20最大支持20个字符。商户系统产生的唯一的订单号，不可重复，中信银行通过“商户编号”和“订单号”唯一确定一笔订单。（必输项）6CURRID订单支VARCHAR201：人民币中信银行网上支付平台订单接口说明（版本V1.2）第3页付币种目前固定送01（必输项）7ORDERAMT订单金额DECIMAL15,2最大长度允许13整数加上2位小数（必输项）8MEMO摘要信息VARCHAR80可以为空。9NOTIFYMODE通知模式VARCHAR201：浏览器URL跳转通知目前固定送01（必输项）10NOTIFYURL通知URLVARCHAR256最大允许256个字符。支付结果通知URL，此URL由第三方提供。（必输项）11RISKLEVEL风险级别VARCHAR2订单风险级别。00：系统默认级别01：大额网关级别具体级别可在业务开通时设定。（必输项）12SUPPTCARDTYPE支持卡种VARCHAR2订单支持的支付卡种。00：借记卡和信用卡01：仅借记卡02：仅信用卡商户可以针对订单设定可接受的支付卡种。（必输项）13TTL订单有效期INTEGER预留。14MEMBERID订单人VARCHAR60可以是用户在商户网站的USERID。长度最大为60个字符。若进行防钓鱼控制（ISSAFEINF字段值为Y），则为必输项；否则，可以为空。中信银行网上支付平台订单接口说明（版本V1.2）第4页15NOTIFYSCOPE支付结果通知范围VARCHAR201：只通知成功订单02：成功和失败订单均通知（必输项）16ISSAFEINF是否进行防钓鱼控制VARCHAR1Y：进行防钓鱼控制；N：不进行防钓鱼控制。防钓鱼控制措施包括：1）商户信任域名验证；2）订单人信息提示；3）支付结果报文返回安全信息：调用B2C支付网关的请求URL；客户确认支付的MAC地址；客户确认支付的IP地址。17REFERER商户信任域名列表VARCHAR256商户信任域名的格式为：xxx.com或xxx.com.cn。例如：商户