支付宝商户接口及技文档-V1.7.doc

商家与支付宝接口:: 批量代发 浙江支付宝网络科技有限公司 产品技术及用户体验部 2007年12月目 录 商家与支付宝接口:: 1 批量代发 1 目 录 2 1. 总述 4 2. 支付宝对外接口技术 5 2.1. 支付宝对外接口概述 5 2.2. 支付宝外部接入接口 5 2.2.1. 接入URL 5 2.2.2. 接入方式 5 2.2.3. 接入类型 5 2.2.4. 接入参数 7 2.2.5. 参数签名机制 9 2.2.6. 签名方式 11 2.3. 支付宝外部通知接口 12 2.3.1. 服务器通知 12 2.3.2. 通知参数 13 2.3.3. 通知验证接口 14 3. 上传付款文件 17 3.1. 接口类型 17 3.2. 请求参数表 17 3.3. 返回结果 19 3.4. 付款文件描述 19 3.4.1. 文件名格式 19 3.4.2. 文件内容格式 19 3.5. 支付宝直连银行 21 3.6. 付款文件银行信息填写规则 22 4. 下载付款结果文件 23 4.1. 接口类型 23 4.1.1. 请求参数表 23 4.2. 批次处理结果文件 24 4.2.1. 文件名格式 24 4.2.2. 文件内容格式 24 4.3. 付款结果文件描述 27 4.3.1. 文件名格式 27 4.3.2. 文件内容格式 28 5. 下载退票结果文件 30 5.1. 接口类型 30 5.1.1. 请求参数表 30 5.2. 退票文件 31 5.2.1. 文件名格式 31 5.2.2. 文件内容格式 31 6. 各银行错误描述附录。 34 总述 本文描述商户与支付宝接口的相关协议 阅读对象：商户网站的技术开发人员 支付宝对外接口技术 支付宝对外接口概述 支付宝对外接口分为两种，一种是接受外部请求的接口，我们统称为外部服务接口。一种是主动通知外部系统的接口，我们统称为外部通知接口。 外部服务接口的主要目的是让外部商户主动使用我们的服务，如：创建交易等。外部通知接口的主要目的是为外部商户提供数据同步服务（如：交易状态同步）以及异步处理结果返回服务（有些业务的处理是无法做到即时返回的）。 支付宝外部接入接口 接入URL /cooperate/gateway.do 接入方式 POST/GET方式 接入类型 系统调用 顾名思义，这类接口是为商户系统获得支付宝系统信息提供服务的，是一种系统间的调用接口。 系统调用示意图 页面跳转 顾名思义，这类接口都是一些有页面操作的接口。通常是用户在商户页面执行部分操作，然后跳转到支付宝页面完成整个操作。有的甚至可能最后还要再跳回到商户的下一个页面，继续完成整个操作。根据处理结果的返回方式，又分为： 立即返回处理结果，即用户在支付宝页面完成操作后，支付宝将处理结果立即返回给商户的下一步操作页面，让用户继续完成整个操作流程。所以，调用这类接口时，必须传递参数return_url（即商户的下一个操作页面）。 立即返回（页面跳转）示意图 异步返回处理结果，即用户从商户页面跳转到支付宝页面后，在支付宝完成最后操作，用户不用再回到合作作伙伴页面。这类接口通常是通过通知接口异步获得处理结果。如果需要异步返回结果，那么必须传递notify_url参数，以指定通知返回的地址。如果不需要异步返回结果，那么可以不用传递notify_url参数。 页面跳转（通过通知接口返回结果）示意图 接入参数 接入参数由协议参数和业务参数共同组成，业务接口中会介绍每个业务接口的输入/输出参数。 协议参数 协议参数 字段名称 变量名 说明 接口名称 service 外部接口名称 商户ID partner 商户在支付宝的用户ID 通知URL notify_url 通知返回URL,仅适用于异步返回处理结果的接口。有些服务是无法立即返回处理结果的，那么需要通过这个URL将处理结果异步返回给商户。（见外部通知接口概述） 返回URL return_url 结果返回URL，仅适用于立即返回处理结果的接口。支付宝处理完请求后，立即将处理结果返回给这个URL。 代理商ID agent 如果一些交易网站的交易，有一定的“代理”所属关系，代理商可以在交易中传递该参数，来表明代理的身份。这里传送的值，请使用代理商所属支付宝账户的PartnerID。 文件摘要 digest_上传文件名 用于标识上传文件的摘要值;多个文件对应会有多个参数；如请求参数中存在digest_upload_file参数时、表示存在一个上传文件、其在请求中的参数名是upload_file、其摘要值是参数digest_upload_file的值 文件摘要算法