支付宝商户接口及技术文档

《支付宝商户接口及技术文档》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、批量代发接口文档商家与支付宝接口::批量代发浙江支付宝网络科技有限公司产品技术及用户体验部2007年12月共34页第-1-页批量代发接口说明书目录商家与支付宝接口::1批量代发1目录21.总述42.支付宝对外接口技术52.1.支付宝对外接口概述52.2.支付宝外部接入接口52.2.1.接入URL52.2.2.接入方式52.2.3.接入类型52.2.4.接入参数72.2.5.参数签名机制92.2.6.签名方式112.3.支付宝外部通知接口122.3.1.服务器通知122.3.2.通知参数132.3.3.通知验证接口143.上传付款文件173.1.接口类型173.2.请

2、求参数表173.3.返回结果193.4.付款文件描述193.4.1.文件名格式193.4.2.文件内容格式193.5.支付宝直连银行213.6.付款文件银行信息填写规则22共34页第-34-页批量代发接口说明书4.下载付款结果文件234.1.接口类型234.1.1.请求参数表234.2.批次处理结果文件244.2.1.文件名格式244.2.2.文件内容格式244.3.付款结果文件描述274.3.1.文件名格式274.3.2.文件内容格式285.下载退票结果文件305.1.接口类型305.1.1.请求参数表305.2.退票文件315.2.1.文件名格式315.2.2.

3、文件内容格式316.各银行错误描述附录。34共34页第-34-页批量代发接口说明书1.总述本文描述商户与支付宝接口的相关协议阅读对象：商户网站的技术开发人员共34页第-34-页批量代发接口说明书1.支付宝对外接口技术1.1.支付宝对外接口概述支付宝对外接口分为两种，一种是接受外部请求的接口，我们统称为外部服务接口。一种是主动通知外部系统的接口，我们统称为外部通知接口。外部服务接口的主要目的是让外部商户主动使用我们的服务，如：创建交易等。外部通知接口的主要目的是为外部商户提供数据同步服务（如：交易状态同步）以及异步处理结果返回服务（有些业务的处理是无法做到即时返回的）

4、。1.2.支付宝外部接入接口1.2.1.接入URLhttps://www.alipay.com/cooperate/gateway.do1.2.2.接入方式POST/GET方式1.2.3.接入类型l系统调用顾名思义，这类接口是为商户系统获得支付宝系统信息提供服务的，是一种系统间的调用接口。共34页第-34-页批量代发接口说明书系统调用示意图l页面跳转顾名思义，这类接口都是一些有页面操作的接口。通常是用户在商户页面执行部分操作，然后跳转到支付宝页面完成整个操作。有的甚至可能最后还要再跳回到商户的下一个页面，继续完成整个操作。根据处理结果的返回方式，又分为：n立即返回处

5、理结果，即用户在支付宝页面完成操作后，支付宝将处理结果立即返回给商户的下一步操作页面，让用户继续完成整个操作流程。所以，调用这类接口时，必须传递参数return_url（即商户的下一个操作页面）。立即返回（页面跳转）示意图共34页第-34-页批量代发接口说明书n异步返回处理结果，即用户从商户页面跳转到支付宝页面后，在支付宝完成最后操作，用户不用再回到合作作伙伴页面。这类接口通常是通过通知接口异步获得处理结果。如果需要异步返回结果，那么必须传递notify_url参数，以指定通知返回的地址。如果不需要异步返回结果，那么可以不用传递notify_url参数。页面跳转（通

6、过通知接口返回结果）示意图1.1.1.接入参数接入参数由协议参数和业务参数共同组成，业务接口中会介绍每个业务接口的输入/输出参数。1.1.1.1.协议参数协议参数字段名称变量名说明接口名称service外部接口名称商户IDpartner商户在支付宝的用户ID通知URLnotify_url共34页第-34-页批量代发接口说明书通知返回URL,仅适用于异步返回处理结果的接口。有些服务是无法立即返回处理结果的，那么需要通过这个URL将处理结果异步返回给商户。（见外部通知接口概述）返回URLreturn_url结果返回URL，仅适用于立即返回处理结果的接口。支付宝处理完请求

7、后，立即将处理结果返回给这个URL。代理商IDagent如果一些交易网站的交易，有一定的“代理”所属关系，代理商可以在交易中传递该参数，来表明代理的身份。这里传送的值，请使用代理商所属支付宝账户的PartnerID。文件摘要digest_上传文件名用于标识上传文件的摘要值;多个文件对应会有多个参数；如请求参数中存在digest_upload_file参数时、表示存在一个上传文件、其在请求中的参数名是upload_file、其摘要值是参数digest_upload_file的值文件摘要算法file_digest_type支持MD5和SHA建议使用MD5签名类型si