拉卡拉第三方账单号支付接入接口文档.doc

北京市朝阳区北苑路170号凯旋城D座6-7层(100101) 电话：86-10传真：86-10 网址： 拉卡拉账单号支付接入规范 副标题：技术标准 版本 1.0.1 修订历史 版本号 作者 内容提要 核准人 发布日期 1.0.1 董复文 赵铭 2008-09-06 1.0.2 李英杰 目 录 TOC \o 1-3 \h \z \u 20230 1、概述 4 11867 1.1、名词解释 4 31681 2、报文签名概述 4 4936 3.通讯报文编码 4 18362 4、账单号支付 5 2754 4.1、账单号支付-查询交易能否支付 5 27708 4.1.1、接口描述 5 9479 4.1.2、业务约束 5 3118 4.1.3、处理流程 5 26263 4.1.4、协作模式 6 6773 4.1.5、请求格式 7 7551 4.1.6、应答格式 8 16546 4.2、账单号支付-交易支付 10 31199 4.2.1、接口描述 10 12261 4.2.2、业务约束 10 19345 4.2.3、处理流程 11 22152 4.2.4、协作模式 11 5663 4.2.5、请求格式 12 1685 4.2.6、应答格式 14 30065 4.3 商户获取拉卡拉账单对帐文件 16 15950 4.3.1、接口描述 16 24791 4.3.2、处理流程 16 2450 4.3.3、对帐文件格式 17 1872 4.3.4、文件内容 17 27512 4.4 Lakala的demo的使用介绍 17 1、概述 拉卡拉账单平台以安全、合规、标准、易用的方式，将拉卡拉的服务发布出来，连接外部合作伙伴，构建开放的价值网络。 拉卡拉账单平台对外发布的服务遵循统一的接口规范。接口规范基于互联网开放标准，符合国家关于金融行业电子化方面的各种法律法规，以及拉卡拉公司对业务与系统风险进行控制的需要。 拉卡拉账单平台接口规范对外部系统与拉卡拉账单平台协作中的交互模式、数据交换格式、安全机制、外部系统接入与管理方式等制定统一的标准。 1.1、名词解释 拉卡拉账单平台 是拉卡拉对外提供的一组标准的基础业务服务，使得拉卡拉的客户可以基于此服务安全、灵活的组装构成满足他们的需求，以实现协同、开放、繁荣的生态圈！ 2、报文签名概述 报文中的签名使用的RSA公私钥技术时,发送报文方使用自己持有的私钥对报文进行签名,然后接收报文方使用公钥对签名进行验签. 拉卡拉持有拉卡拉私钥和商户的公钥。商户持有商户自己的私钥和拉卡拉的公钥。拉卡拉将原文使用拉开拉私钥进行签名和原文传输给商户。商户接收之后，将原文按照报文说明中的顺序及方式组织。进行验签。商户将信息返回给拉卡拉系统时，将原文按照本文档说明的进行结构和顺序，进行签名，然后和原文一起回应给拉卡拉。拉卡拉系统进行验签。 报文中的签名使用的是MD5数字签名,双方约定mackey,报文中明文不传mackey,摘要原文按照接口 拉卡拉提供商户的具体签名方法。针对不同的开发环境，拉卡拉提供响应的接口。和接口说明。 具体的签名内容参见报文. 3.通讯报文编码 通讯报文中采用key=value的形式，value,统一使用utf-8的编码格式。 4、账单号支付 4.1、账单号支付-查询交易能否支付 拉卡拉账单平台向合作伙伴系统发起查询交易能否支付请求 4.1.1、接口描述 合作伙伴用户到拉卡拉的下属网点申请合作伙伴支付业务、提供合作伙伴的交易号和支付金额。拉卡拉系统首先查询合作伙伴系统确认交易能否支付后再发送支付请求 4.1.2、业务约束 约束： 交易的状态为”等待买家付款” 支付的金额和交易的金额需一致 交易的买家状态必须合法 4.1.3、处理流程 流程如下图所示: 合作伙伴用户在拉卡拉的线下网点提供合作伙伴交易号和金额、通过口授或者填写网点的单子 拉卡拉网点核实合作伙伴交易号和金额、网点营业员需要提醒用户所提供正确的交易号和金额 合作伙伴是一串16位的数字、不包含数字等其他类型的字符 拉卡拉网点营业员在其终端录入合作伙伴交易号和金额 拉卡拉终端系统向合作伙伴系统发起查询请求 拉卡拉系统根据需要处理自己的业务 拉卡拉系统向合作伙伴查询交易能否支付、请求中带有合作伙伴交易号和金额 合作伙伴系统查询交易能否支付 合作伙伴返回交易能否支付结果 拉卡拉账单平台系统根据需要进行业务处理、并向其网点返回能否支付的信息 拉卡拉网点将能否支付结果告知合作伙伴用户 11.合作伙伴用户核实本次查询结果 4.1.4、协作模式 请求/响应交互模式。 使用紧凑型的参数格式。 在业务流程第5~