支付宝-物流通信接口(增加流水号).doc
60页
物流通信接口版本号：1.5支付宝（中国）网络技术有限公司 版权所有物流通信接口目 录1 文档说明 61.1 功能描述 61.2 阅读对象 61.3 业务术语 71.4 技术服务 72 物流通信流程图 83 数据交互 103.1 同步请求 103.2 异步请求 114 报文头定义 124.1 请求报文头 124.1.1 含义 124.1.2 列表 124.1.3 样例 134.2 响应报文头 134.2.1 含义 134.2.2 列表 134.2.3 样例 145 报文体定义 155.1 送货员登录（MI0001） 155.1.1 含义 155.1.2 列表 155.1.3 样例 165.2 派件支付结果反馈（MI0005） 175.2.1 含义 175.2.2 列表 175.2.3 样例 195.3 派件签收结果反馈（MI0006） 205.3.1 含义 205.3.2 列表 205.3.3 样例 215.4 撤消交易结果反馈（MI0007） 225.4.1 含义 225.4.2 列表 225.4.3 样例 245.5 派件异常反馈（MI0008） 255.5.1 含义 255.5.2 列表 255.5.3 样例 265.6 运单查询（MI0010） 275.6.1 含义 275.6.2 列表 275.6.3 样例 295.7 退款申请（MC0001） 305.7.1 含义 305.7.2 列表 315.7.3 样例 335.8 退款通知（MC0002） 345.8.1 含义 345.8.2 列表 355.8.3 样例 375.9 退款银行卡验证（MC0003） 385.9.1 含义 385.9.2 列表 385.9.3 样例 395.10 揽件（MG0001） 405.10.1 含义 405.10.2 列表 405.10.3 样例 425.11 查询商户派件异常码（MI0021） 435.11.1 含义 435.11.2 列表 435.11.3 样例 446 签名机制 456.1 签名字符串 456.2 加密流程 456.3 密钥规范 517 建议与意见 518 附录 528.1 业务种类编号 528.2 派件异常编码 528.3 通信报文响应CODE说明 538.4 配送商户CODE说明 548.5 B2C商户订单类型 558.6 支持现金退款到银行卡的银行列表 558.7 退款申请异常编码 568.8 退款通知异常编码 578.9 退款银行卡验证异常编码 57支付宝（中国）网络技术有限公司 版权所有| 版本：1.5 第5页物流通信接口1 文档说明1.1 功能描述支付宝物流通信接口主要用于支付宝与物流公司的信息查询和同步，以及淘宝商超退款。
说明：退款功能目前暂时仅提供给淘宝商超使用，不提供给物流平台与物流公司的交互具体包括以下8个接口：l 送货员登录l 派件支付结果反馈l 派件签收结果反馈l 撤销交易结果反馈l 派件异常结果反馈l 运单查询l 揽件l 查询商户派件异常码与淘宝商超的交互具体包括以下4个接口：l 退款申请l 退款通知l 退款银行卡验证l 揽件1.2 阅读对象支付宝物流通信接口面向物流公司的系统开发维护或进行管理的相关人员这些人员必须具有一定系统通信知识和物流业务知识1.3 业务术语表1-1 业务术语术语解释报文支付宝和物流通信采用https协议发送XML格式的消息，每一个业务报文都由一个XML根节点下的报文头（XML节点）和报文体（XML节点）组成，具体结构详见各通信报文样例通信采用httpclient方式Httpclienthttpclient是Apache Jakarta Common下的子项目，用来提供高效的、最新的、功能丰富的、支持HTTP协议的客户端编程工具包MPOS系统支付宝的移动POS运单管理系统请求通过HTTP协议把需要传输的数据发送给接收方的过程淘宝商超即淘宝商城网上超市，是淘宝商城下属的一个垂直行业，类似1号店。
通联通联支付网络服务股份有限公司，和支付宝合作的一个线下收单公司通知支付宝给物流通知，如果没有响应，将进行重试，直到收到物流响应为止一共重试7次，重试策略为1m、3m、10m、30m、1h、2h、5h如果7次以后还是失败，则通过T+1对账来进行数据同步或者支付宝手动触发进行通知恢复m=minute，h=hour，T=today）物流宝为淘宝商超提供物流服务及物流信息管理的系统平台淘宝物流平台即淘宝COD物流平台CODCash On Delivery， 即“货到付款”揽件物流学中的名词，意思为物流公司承接客户任务，并保证在一定时间内完成响应通过HTTP协议把需要处理完的结果数据返回给发送方的过程1.4 技术服务在开发或使用支付宝接口时，产生疑问或出现问题，可点击下面的链接填写表单，提交技术问题，支付宝技术支持人员会主动联系并及时处理 支付宝论坛接口集成专区： 支付宝商户客服热线：0571-881580902 物流通信流程图POS终端、支付宝、物流公司整体交互如图2-1所示图2-1 POS终端、支付宝、物流通信主流程图 淘宝商超、支付宝（现金退款到账户）整体交互如图2-2所示图2-2 淘宝商超、支付宝通信主流程图淘宝商超、支付宝和银行（现金退款到银行卡）整体交互如图2-3所示。
图2-3 淘宝商超、支付宝、银行通信主流程图 淘宝商超、支付宝和通联（刷卡退款到原银行卡）整体交互如图2-4所示图2-4 淘宝商超、支付宝、通联通信主流程图POS终端、支付宝、物流公司和淘宝物流平台揽件（淘宝揽件）整体交互如图2-5所示图2-5 POS终端、支付宝、物流公司、淘宝物流平台通信主流程图POS终端、支付宝、物流公司揽件（非淘宝揽件）整体交互如图2-6所示图2-6 POS终端、支付宝、物流公司通信主流程图支付宝、物流公司查询派件异常码信息整体交互如图2-7所示图2-7 支付宝、物流公司通信主流程图3 数据交互3.1 同步请求POS终端、支付宝、物流同步请求流程如图3-1所示图3-1 POS终端、支付宝、物流公司同步请求流程图(1) POS端发送同步请求到支付宝；(2) 支付宝处理请求；(3) 将POS端的请求同步转发给物流公司；(4) 物流公司返回请求结果；(5) 支付宝处理物流请求结果； (6) 支付宝将处理结果返回给通联同步交互方式使用于“送货员登录”、“运单查询”、“揽件”、“查询商户派件异常码”接口3.2 异步请求POS终端、支付宝、物流异步请求流程如图3-2所示。
图3-2 POS终端、支付宝、物流公司异步请求流程图 (1) POS终端发送请求给支付宝；(2) 支付处理请求，注册异步通知；(3) 支付宝返回异步请求结果；(4) 支付宝异步通知请求物流公司；(5) 物流公司返回异步请求结果异步请求方式适用于“派件支付结果反馈”、“派件签收结果反馈”、“撤销交易结果反馈”、“派件异常反馈”接口4 报文头定义4.1 请求报文头4.1.1 含义支付宝向物流发起请求的报文头信息，格式为XML节点，报文元素名均为该节点下的子节点名4.1.2 列表表4-1 请求报文头参数说明报文元素最大长度说明是否必填样例transaction_id6请求业务种类编号取值范围请参见“8.1 业务种类编号”是MI0010MAC400报文验签串签名内容采用RSA算法，对报文头（
是1111111111target10应答方，需填写物流公司英文名称是STAREXPRESSc32唯一流水号（同一笔请求报文的流水号是一致的订单查询，登录，退款申请，退款通知，揽件，查询商户异常码请求报文中不包含）是2011090201010202request_time14请求时间，格式为yyyyMMddHHmmss是20101227134315version5版本号，目前默认为1.0是1.0ext_attributes无限制格式要求是<自定义字段名>自定义字段值，支持多个节点字段，不支持节点嵌套节点否
