欧飞Sup供货接口V2.2.docVIP

欧飞Sup供货系统 供货接口规范 江苏欧飞电子商务有限公司 2012年6月28日 Version：V2.2 文档管理记录 日 期 修 改 修 改 者 版 本 2012/04/20 建立文档 欧飞Sup运营团队 V2.0 2012/05/21 返回充值结果时增加模板编号参数 欧飞Sup运营团队 V2.1 2012/06/28 新增返回频繁请求状态码7777 欧飞Sup运营团队 V2.2 2012/06/28 V2.2更新说明： 接口参数中新增返回频繁请求状态码7777，默认访问时间为5秒每次，如供货商访问频繁则 会提示7777错误。 2012/05/25 V2.1更新说明： 接口参数中增加模版编号值，支持自定义模版中配置的商品充值策略，自动触发充值模版中的失败退款等功能，提升处理效率，降低人工操作。 目录 目录 I 一．文档说明 2 1.1文档目的 2 1.2读者对象 2 二．交互模式 2 2.1 请求/响应交互模式 2 2.2. 主动通知交互模式 3 三．安全规范 3 3.1 安全配置 3 3.2 数据加密及数字签名 4 3.3 访问控制 4 3.4指令日志 4 四．供货接口 4 1.1接口说明 4 1.2接口流程 4 1.3订单获取接口 6 4.4漏单检查接口（可选） 8 4.5订单充值前确认接口 10 4.6返回充值结果接口 12 五．供货商管理 13 六．附加信息说明 14 1.1供货请求响应返回码信息 14 七．开发支持 14 一．文档说明 文档目的 欧飞Sup供货商接入系统，为供货商提供了一套完善的供货接口，为供货商提供订单获取与充值结果返回服务。 欧飞Sup供货商类型为供货形式及采购形式，目前只提供供货形式的供货商业务； 开放供货接口给供货商的同时，需要供货商在欧飞Sup供货系统上开通帐户； 开发接口需要供货商在欧飞Sup供货系统配置接口相关参数，提供实时接口供供货商查询使用； 供货接口包括： 订单获取接口 漏单检查接口（可选） 订单充值前校验接口 返回充值结果接口 读者对象 本文档阅读对象为欧飞Sup供货商的开发技术。 二．交互模式 2.1 请求/响应交互模式 请求/响应模式是最常用的一种模式。在这种交互模式下，合作商系统向欧飞Sup供货系统发送请求数据，并同步等待欧飞Sup供货系统处理完毕之后返回的响应数据直至流程结束。 服务请求是使用HTTP协议发送给欧飞Sup供货系统的，请求数据以POST形式提交。 2.2. 主动通知交互模式 暂不开放。 三．安全规范 3.1 安全配置 安全配置包括以下内容： 签名密钥配置（必选） 请求签名算法及密钥MD5 返回签名算法及密钥MD5 加密密钥配置（可选） 请求加密算法及密钥MD5 返回加密算法及密钥MD5 注： 签名算法和密钥是必须的，加密算法和加密密钥为可选（只有一些特殊接口可能必须）。 3.2 数据加密及数字签名 在通讯过程中，采用RSA加密算法，欧飞Sup供货系统产生公私密钥对，将公钥分配给供货商；供货商产生公私密钥对，将公钥分配给欧飞；交易过程中，对关键信息全文做数字摘要，再用私钥加密；关键信息域全文用公钥加密。接收报文方对密文解密，验签；而保证了数据的保密性、完整性和不可抵赖性。 3.3 访问控制 欧飞Sup供货系统是根据请求参数中的供货商Id来判断合作商的请求是否可以执行。 供货商在访问供货接口之前，必须先开通供货接口的访问权限并在欧飞Sup供货系统生成接口密钥。 3.4指令日志 欧飞Sup供货系统会在国家相关法律法规要求的时限内保存合作商与欧飞之间所有完整交互指令，以方便日后为解决商业纠纷提供日志证据。合作商也应当按照国家相关法律法规的要求保存来自欧飞的响应数据与主动通知数据。 四．供货接口 接口说明 本接口主要目的是为了让供货商接入欧飞Sup供货系统，能够在合作商系统中实现获取订单完成充值后将充值结果返回。 合作商系统作为请求客户端，按照本接口的约定发送请求，而欧飞Sup供货系统监听来自合作商系统的请求给于处理，处理完成后将相关处理结果通知给合作商系统。 接口流程 接口流程图： 步骤说明： 合作商系统向欧飞系统发起订单获取请求，欧飞系统将待充值的订单返回给合作商系统； 合作商系统在收到待充值的订单后发送一次确认信息，查看是否存在漏单，欧飞系统核实之前发送的待充值订单记录，并将检查结果返回给合作商系统（该步骤可选）； 合作商系统在处理单笔订单前再次向欧飞系统发送充值前确认请求，核实该笔订单状态是否有变更，欧飞系统将确认结果返回给合作商系统； 合作商收到确认结果后开始处理订单，订单处