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

拉卡拉账单号支付接入规范 副标题：技术标准 版本 1.0.1 修订历史 版本号 作者 内容提要 核准人 发布日期 1.0.1 董复文 赵铭 2008-09-06 1.0.2 李英杰 目 录 1、概述 4 1.1、名词解释 4 2、报文签名概述 4 3.通讯报文编码 4 4、账单号支付 5 4.1、账单号支付-查询交易能否支 5 4.1.1、接口描述 5 4.1.2、业务约束 5 4.1.3、处理流程 5 4.1.4、协作模式 6 4.1.5、请求 7 4.1.6、应答 8 4.2、账单号支付-交易支付 10 4.2.1、接口描述 10 4.2.2、业务约束 10 4.2.3、处理流程 11 4.2.4、协作模式 11 4.2.5、请求 12 4.2.6、应答 14 4.3 商户获取拉卡拉账单对帐文件 16 4.3.1、接口描述 16 4.3.2、处理流程 16 4.3.3、对帐文件格式 17 4.3.4、文件内容 17 4.4 Lakala的demo的使用介绍 17 1、概述 拉卡拉账单平台以安全、合规、标准、易用的方式，将拉卡拉的服务发布出来，连接外部合作伙伴，构建开放的价值网络。 拉卡拉账单平台对外发布的服务遵循统一的接口规范。接口规范基于互联网开放标准，符合国家关于金融行业电子化方面的各种法律法规，以及拉卡拉公司对业务与系统风险进行控制的需要。 拉卡拉账单平台接口规范对外部系统与拉卡拉账单平台协作中的交互模式、数据交换格式、安全机制、外部系统接入与管理方式等制定统一的标准。 1.1、名词解释 拉卡拉账单平台 是拉卡拉对外提供的一组标准的基础业务服务，使得拉卡拉的客户可以基于此服务安全、灵活的组装构成满足他们的需求，以实现协同、开放、繁荣的生态圈！ 2、报文签名概述 报文中的签名使用的RSA公私钥技术时,发送报文方使用自己持有的私钥对报文进行签名,然后接收报文方使用公钥对签名进行验签. 拉卡拉持有拉卡拉私钥和商户的公钥。商户持有商户自己的私钥和拉卡拉的公钥。拉卡拉将原文使用拉开拉私钥进行签名和原文传输给商户。商户接收之后，将原文按照报文说明中的顺序及方式组织。进行验签。商户将信息返回给拉卡拉系统时，将原文按照本文档说明的进行结构和顺序，进行签名，然后和原文一起回应给拉卡拉。拉卡拉系统进行验签。 报文中的签名使用的是MD5数字签名,双方约定mackey,报文中明文不传mackey,摘要原文按照接口 拉卡拉提供商户的具体签名方法。针对不同的开发环境，拉卡拉提供响应的接口。和接口说明。 具体的签名内容参见报文. 3.通讯报文编码 通讯报文中采用key=value的形式，value,统一使用utf-8的编码格式。 4、账单号支付 4.1、账单号支付-查询交易能否支合作伙伴用户到的下属网点申请支付业务、提供的交易号和支付金额系统首先查询系统确认交易能否支付”等待买家付款” 支付的金额和交易的金额需一致 交易的买家状态必须合法 4.1.3、处理流程 流程如下图所示用户在的线下网点提供和金额、通过口授或者填写网点的 拉卡拉网点核实和金额、网点营业员需要提醒用户提供正确的 拉卡拉网点营业员在其终端录入 拉卡拉终端系统向合作伙伴系统发起请求 系统 拉卡拉系统向合作伙伴查询交易能否支付、请求中带有合作伙伴交易号和金额 合作伙伴系统 合作伙伴返回交易能否支付结果 拉卡拉账单平台系统根据需要进行业务处理、并向其网点返回能否支付的信息 拉卡拉网点将能否支付结果告知合作伙伴用户 11.合作伙伴用户核实本次查询结果 4.1.4、协作模式 请求/响应交互模式。 使用紧凑型的参数格式。 在业务流程第5~步的交互过程如下图所示 4.1.5、请求请求参数字段名 变量名 类型/格式 说明 可空 通用参数 v 1.1,商户响应原样返回 N 服务 service lakala.agency.tradePayConsultBalance 商户在响应报文中原样返回 N 拉卡拉商户号 mer_id 由提供 安全号配置号 sec_id 由提供 N 请求ID req_id 参见数据格式部分(拉卡拉产生的商户可以不关注,按照原值返回) N 业务参数agency_pay_consult_balance_req) 账单号 trade_no String(16) 合作伙伴账单号(用户的帐号,或者合作伙伴平台的订单号) N 金额 amount Number(,2) 以元为单位、范围为[0，999999.99] N 拉卡拉查询时间 _query_time Timestamp 拉卡拉的时间、格式为YYYYMMDDhhmmss N sign