共 30 页 第 - 1 - 页
实物商品交易服务
集成技术文档
Version 1.35
支付宝公司版权所有
共 30 页 第 - 2 - 页
目录
前言...................................................................................................................................................4
支付宝对外接口概述.......................................................................................................................4
支付宝外部服务接口概述...............................................................................................................5
接入URL...................................................................................................................................5
接入方式...................................................................................................................................5
接入类型...................................................................................................................................5
协议参数...................................................................................................................................7
输入参数...........................................................................................................................7
输出参数...........................................................................................................................8
HTTP参数签名机制.................................................................................................................8
签名方式...................................................................................................................................9
支付宝外部通知接口概述.............................................................................................................10
通知服务器介绍.....................................................................................................................10
通知系统的特点.....................................................................................................................11
协议参数.................................................................................................................................11
通知验证接口.........................................................................................................................12
输入参数.........................................................................................................................12
输出参数.........................................................................................................................12
HTTP通知验证接口...............................................................................................................12
输入参数.........................................................................................................................13
输出参数.........................................................................................................................13
支付宝“实物商品交易服务”接口说明.....................................................................................14
接口类型.................................................................................................................................14
输入参数.................................................................................................................................14
输出格式.................................................................................................................................17
错误代码.................................................................................................................................17
支付宝“实物商品交易服务”通知接口说明.............................................................................18
通知参数.................................................................................................................................18
共 30 页 第 - 3 - 页
通知格式.................................................................................................................................20
应答输出.................................................................................................................................20
公用枚举表.....................................................................................................................................22
证件类型枚举表.....................................................................................................................22
支付类型枚举表.....................................................................................................................22
用户状态枚举表.....................................................................................................................23
交易动作枚举表.....................................................................................................................23
交易状态枚举表.....................................................................................................................24
物流状态枚举表.....................................................................................................................24
退款状态枚举表.....................................................................................................................25
物流类型枚举表.....................................................................................................................25
物流支付方式枚举表.............................................................................................................25
超时参数枚举表.....................................................................................................................26
通知返回结果枚举表.............................................................................................................29
错误代码枚举表.....................................................................................................................29
共 30 页 第 - 4 - 页
前言
支付宝“实物商品交易服务”是支付宝推出的网络安全交易服务之一，适用于在网络上
销售实物商品。关于“实物商品交易服务”的更多介绍，请参看《实物商品交易服务说明》
文档
“实物商品交易服务”基于支付宝公司的“支付宝交易服务”，通过支付宝公司在交易
过程中作为第三方信用担保，以实现买卖双方网络交易的安全。更多“支付宝”交易的介绍，
请
点击这里。
本文档以下内容包含的是实现“实物商品交易服务”的技术接口说明，包含：
z 支付宝对外接口概述
z 支付宝外部服务接口概述
z 支付宝外部通知接口概述
z 支付宝“实物商品交易服务”接口说明
z 支付宝“实物商品交易服务”通知接口说明
z 公用枚举表
支付宝对外接口概述
支付宝对外接口分为两种，一种是接受外部请求的接口，我们统称为外部服务接口。一
种是主动通知外部系统的接口，我们统称为外部通知接口。
外部服务接口的主要目的是让外部合作伙伴主动使用我们的服务，如：创建交易等。外
部通知接口的主要目的是为外部合作伙伴提供数据同步服务（如：交易状态同步）以及异步
处理结果返回服务（有些业务的处理是无法做到即时返回的）。
支付宝外部服务接口概述
接入 URL
https://www.alipay.com/cooperate/gateway.do
接入方式
POST/GET 方式
接入类型
z 系统调用
顾名思义，这类接口是为合作伙伴系统获得支付宝系统信息提供服务的，是一种系
统间的调用接口。如：会员信息查询接口。
系统调用示意图
z 页面跳转
顾名思义，这类接口都是一些有页面操作的接口。通常是用户在合作伙伴页面执行
部分操作，然后跳转到支付宝页面完成整个操作。有的甚至可能最后还要再跳回到合作
共 30 页 第 - 5 - 页
- 1
- 2
前往页