支付宝第三方合作手册
张景波 整理
资料来源于“支付宝官方网站”
2012 年 3 月
目 录
一、 网站签约 --------------------------------------------------------------------------3
什么样的网站可以合作签约？ ----------------------------------------------------3
为什么要进行实名认证？ ----------------------------------------------------------4
公司类型商家账户如何认证？ ----------------------------------------------------4
有哪些产品可以在线申请？------------------------------------------------------10
合作接口费率如何计算收费？（收费标准）---------------------------------11
如何判断选择合作接口类型？---------------------------------------------------12
平台商网站接口与普通网站接口有什么区别？------------------------------13
如何在线提交签约申请？---------------------------------------------------------14
签约申请表单填写有哪些注意事项？------------------------------------------16
二、订单审核 -----------------------------------------------------------------------------18
常见订单状态有哪几种？---------------------------------------------------------18
如何进行确认订单操作？---------------------------------------------------------19
我的订单为什么会被审核退回？------------------------------------------------22
如何修改被退回的订单？---------------------------------------------------------24
订单审核需要多久时间？---------------------------------------------------------26
什么情况下需要作废取消定单？------------------------------------------------26
三、技术集成 -----------------------------------------------------------------------------27
如何查询合作身份者 ID（partner）和交易安全校验码（key） ----------27
支付宝接口如何集成？------------------------------------------------------------29
如何在线申请技术帮助服务？---------------------------------------------------30
如何调试支付宝接口？------------------------------------------------------------32
常见错误代码总汇表---------------------------------------------------------------35
买家手动关闭了返回页面，交易订单如何更新？---------------------------40
商家后台为什么没有收到交易通知？------------------------------------------42
为什么支付宝不断的发通知？---------------------------------------------------44
如何在线申请技术帮助服务？---------------------------------------------------47
四、推广续签 -----------------------------------------------------------------------------49
什么是商家活动？------------------------------------------------------------------49
支付宝微客平台商家使用手册---------------------------------------------------49
商家如何入驻接入一淘（etao）？----------------------------------------------59
在哪里报名关注商家活动？------------------------------------------------------67
参加活动的商品有些什么要求？------------------------------------------------69
什么是到期续签？------------------------------------------------------------------69
如何查询订单生效及到期时间？------------------------------------------------69
什么是量到续签？------------------------------------------------------------------70
如何查询包量订单已使用的流量？---------------------------------------------70
如何进行量到续签操作？---------------------------------------------------------71
合作总体流程图
一、网站签约
什么样的网站可以合作签约？
2012 年 01 月 20 日
可以合作的网站判断标准为：
1、网站已建设完善完成，非建设中的网站，有商品展现，网址能正常打开浏览（论坛
类合作网站需有非本网站自发的信息）；
2、部分产品及接口合作需要网站备案（团购网站和网银支付产品要求签约账户与备案
主体一致）；
3、接口类产品合作需为独立网站，不包含淘宝同名店铺链接；
4、登陆类网站需要提供测试账号和密码，以便测试审核；
5、网站不涉及禁售类产品，部分限售类产品需要根据页面提示提供资质进行合作。网
站禁售产品请点此查看！
网站合作 实名认证 产品选择 签约申请
为什么要进行实名认证？
2012 年 01 月 20 日
支付宝实名认证：
是由支付宝（中国）网络技术有限公司提供的一项身份识别服务，支付宝实名认证同时
核实会员身份信息和银行账户信息，通过支付宝实名认证后，相当于拥有了一张互联网身份
证，可以在淘宝网等众多电子商务网站开店、出售商品，增加支付宝账户拥有者的信用度。
（如支付宝账户还未通过实名认证，需要修改名字或身份证号码，可以申请实名认证，认证
通过后便无法取消，支付宝账户的名字或身份证号码即可变更。）
同时为创建良好的网上购物环境，支付宝合作商家拥有认证通过的账户是签约的前提。
认证类型：
支付宝实名认证分为：个人认证、商家认证和关联认证、升级认证。
公司类型商家账户如何认证？
2012 年 01 月 20 日
公司类型合作商家针对为有大陆工商局所出具的营业执照进行认证。
1、打开 ，登录支付宝账户，点击【立即点此申请】；
2、点击【立即申请】；
3、填写公司信息，点击【下一步】；
4、填写公司对公银行账户信息，点击【下一步】；
5、填写申请人信息，（若申请人非法人，需要提供委托书），点击【下一步】；
6、填写完毕之后，进入确认信息页面；
7、点击“确认信息并提交”页面提示“提交成功，等待客服审核”；
8、营业执照审核通过，需要在 3 个工作日等待打款，打款成功之后，登录到支
付宝账户，点击【申请认证】——点击【输入打款金额】；
9、输入银行打款金额后，点击【确认】；
10、通过之后，页面提示“您已通过商家认证”。
有哪些产品可以在线申请？
2012 年 01 月 20 日【字号：大 中 小】【打印】【收藏】
确定需要签约的产品后，可以在商家服务平台在线选择产品自助签约，若页面没
有您所需要的产品，可以联系商家服务专线咨询是否可以签约。
普通网站接口产品
平台商接口产品
账务清算产品
增值服务产品
一、普通网站接口产品有：
普通网站接口
担保交易收款（阶梯费率） 点此进入申请页面
担保交易收款 600 套餐 点此进入申请页面
担保交易收款 1800 套餐 点此进入申请页面
担保交易收款 3600 套餐 点此进入申请页面
即时到帐收款（阶梯费率） 点此进入申请页面
即时到帐收款 600 套餐 点此进入申请页面
即时到帐收款 1800 套餐 点此进入申请页面
即时到帐收款 3600 套餐 点此进入申请页面
双功能收款（阶梯费率） 点此进入申请页面
双功能收款 600 套餐 点此进入申请页面
双功能收款 1800 套餐 点此进入申请页面
双功能收款 3600 套餐 点此进入申请页面
网银支付 点此进入申请页面
担保买卖专业版（新便签支付）点此进入申请页面
二、平台商（第三方）接口产品有：
平台商接口
平台商担保交易收款 600 套餐 点此进入申请页面
平台商担保交易收款 3600 套餐点此进入申请页面
平台商即时到帐收款 600 套餐 点此进入申请页面
平台商即时到帐收款 3600 套餐点此进入申请页面
平台商双功能收款 600 套餐 点此进入申请页面
平台商双功能收款 3600 套餐 点此进入申请页面
三、账户务清算产品有：
账务清算
支付宝账户内大额收付款点此进入申请页面
批量付款到支付宝账户 点此进入申请页面
四、增值服务产品有：
增值服务
COD 货到付款平台点此进入申请页面
商户网端大额收款 点此进入申请页面
快捷登录 点此进入申请页面
非证书余额支付 点此进入申请页面
集分宝批量自助发 点此进入申请页面
合作接口费率如何计算收费？（收费标准）
2012 年 01 月 21 日【字号：大 中 小】【打印】【收藏】
合作接口产品费率分单笔阶梯和包量两种。
一、单笔阶梯费率收费：
套餐名称 预付费 交易流量 费率 服务期限
0-6 万元 %
6-50 万元 %
50-100 万元 %
100 万元-200 万元 %
阶梯套餐 0 元
200 万元以上 %
一年
阶梯费率算法示例：如您的交易量为 12 万，则您的费率为 6 万*%+（12 万-6
万）*%= 万元。
在签约的一年内，可享受交易流量累积，享受对应阶梯费率。
合作期间内，按单笔交易流量收取对应交易额费率，不产生交易流量不收费。
二、包量套餐收费：
套餐名称 预付费 交易流量 折合费率 超量费率 服务期限
600 包量套餐 600 元 6 万元 % %
1800 包量套
餐
1800 元 20 万元 % %
3600 包量套
餐
3600 元 45 万元 % %
一年
若在线申请的包量套餐无法满足您实际交易流量所需，可致电商家服务专线咨询
核实。
如何判断选择合作接口类型？
2012 年 01 月 21 日
商家合作接口类型一共有三种：担保交易接口、即时到账接口、双功能接口
一、担保交易接口特征：
买家拍下交易先将资金支付交易，存入支付宝的中间账户并通知卖家发货，买家
确认收货后资金自动进入卖家支付宝账户，完成交易。 付款-发货-收货的交易
过程根据交易超时时间进行推进。深受买家喜爱与信赖。
商家集成此接口，交易买家只能使用担保交易模式。如下图所示：
平台商网站接口与普通网站接口有什么区别？
2012 年 01 月 20 日
区别点：
区别 合作形式 收款账户 商品归属
交易资金所
得
分润功能
普通网站即时
到账接口产品
有
普通网站担保
交易接口产品
支付宝与
签约商家
唯一 签约商家 签约商家
无
平台商即时到
账接口产品
有
平台商担保交
易接口产品
支付宝和
签约商家、
签约商家
和网店卖
家
多个 网店卖家 网店卖家
无
相同点：
1、签约包量产品，若产生超量费用，均由签约商家向支付宝支付。
如何在线提交签约申请？
2012 年 01 月 21 日
1、打开 ，在商家服务-产品商店，选择适合您的产品，点击在线申
请：
2、登陆签约的支付宝账户；
3、在表单中填入您的签约网站信息，例如任选商品签约如下图。如果此时您支
付宝账户还未认证，请注意确认合同后认证时提交的证件信息需与此处显示的信
息一致。如果不一致，认证通过后，支付宝账户信息将会被统一成证件信息，而
这份合同将无法生效，您需要通过上一级签约页面重新签约一次：
4、请确认订单中的协议信息：
5、完成签约，进入审核阶段：
签约申请表单填写有哪些注意事项？
2012 年 01 月 21 日【字号：大 中 小】【打印】【收藏】
签约申请表单填写如下图所示：
注意事项：
1、网站已建设完善完成，非建设中的网站，有商品展现，网址能正常打开浏览
（论坛类合作网站需有非本网站自发的信息）；
2、部分产品及接口合作需要网站备案（团购网站和网银支付产品要求签约账户
与备案主体一致）；
3、接口类产品合作需为独立网站，不包含淘宝同名店铺链接；
4、登陆类网站需要提供测试账号和密码，以便测试审核；
5、网站不涉及禁售类产品，部分限售类产品需要根据页面提示提供资质进行合
作。网站禁售产品请点此查看！
6、所属行业归类判断与所需资质，请点此查看！
7、带*号项需如实填写，以便将订单存在的问题及时与您联系！
二、订单审核
常见订单状态有哪几种？
2012 年 01 月 29 日【字号：大 中 小】【打印】【收藏】
1、审核中
说明您的订单已经进入支付宝审核阶段，此时您不能修改订单信息，但是可以修改联系
人信息。
2、待认证
说明您没有通过支付宝实名认证，您可点此申请。如果 40 天内未完成实名认证，您的
订单将被取消。
3、认证需升级
说明您尚未完成升级实名认证，您可点此申请或查看升级认证进程。如果 40 天内未完
成升级实名认证，您的订单将被取消。
4、退回
说明您的订单没有通过审核，点击订单详情查看退回原因。
确认订单 审核订单 修改订单 作废订单
5、待付款
说明您的订单需要付款，且您未完成付款。如果 40 天内未完成付款操作，您的订单将
被取消。
6、待确认
说明您的订单需要您确认，您可点击订单详情后完成确认。如果 40 天内未完成确认操
作，您的订单将被取消。
7、待集成
说明您的订单中有需要集成的产品，你将支付宝接口集成至您的网站。如果 40 天内未
完成集成操作，您的订单将被取消。
8、已完结
说明您的订单已经完成，您的产品即将生效。
9、失效
说明您的订单超时未操作或是已被取消。
如何进行确认订单操作？
2012 年 01 月 29 日【字号：大 中 小】【打印】【收藏】
1、若订单提交方式为 -产品商店自助提交签约，无需要操作确认订
单步骤，直接进入审核环节。
2、若订单为人工帮助提交订单，则需要登陆 -我的商家服务-我的订
单-操作栏内进行确认订单，否则订单将无法进入审核环节，40 天不操作则超时
处理，订单失效：
3、在订单信息页阅读支付宝商家服务协议进行确认订单操作：
4、确认订单无误，选择付款操作：
5、付款方式有在线付款和线下汇款两种方式：
在线付款：通过签约的支付宝账户进行付款，可以选择余额、网银等方式。
线下汇款：通过银行进行转账至支付宝对公账户，汇款信息（户名：支付宝（中
国）网络技术有限公司 开户行： 招商银行杭州分行营业部 账号：
571904478210901）；
特别提醒：为确认打款人身份，打款时备注中一定要写明此笔产品订单号、签约
支付宝账号。付款完成后，请务必联系 0571-88158090。
6、付款完成后，审核进行 3 个工作日（审核和付款可以同时进行），审核通过
后，订单上线生效 3 个工作日。
我的订单为什么会被审核退回？
2011 年 12 月 20 日【字号：大 中 小】【打印】【收藏】
您的订单被驳回可能存在以下几种情况，请您查看驳回理由，并根据驳回理
由的提示，对应修改建议进行修改后再重新提交订单，即可进入审核环节，审核
时间为 3 个工作日，请您耐心等待！
驳回理
由
具体原因 修改建议
无网址 商家申请时未填写网址，请补充您正确的网址
登陆页面
商家填写的网址需要提供测试账号才能访问，请
等待支付宝工作人员联系您
网站无法显示
商家填写的网址无法打开，请修改您的网址信息
并确保能够打开
网站链接到淘宝
商家填写的网址链接到淘宝、拍拍、诚信通等无
法申请本产品的网址，请修改您正确的网址
无效网址
商家填写的网址链接到外文网址或博客，请修改
您正确的网址
网址问
题
网站建设中
商家填写的网站还未建设完成，请建设完成后再
申请（确保商品信息完整）
滥用信任商家标
识
商家滥用了支付宝信任商家标识，请撤掉后再申
请滥用标
识 滥用特约商家标
识
商家滥用了支付宝特约商家标识，请撤掉后再申
请
个人/公司团购（或含团购版块）不能签约即时到
账产品，请选择其他产品签约
团购 团购
个人/公司团购（或含团购版块）不能签约双功能
产品，请选择其他产品签约
禁售
您的网站内包含国家规定禁止销售的商品或服务
（如黄、赌、毒类商品），无法申请支付宝经营范
围
限售
你的网站内包含国家规定限制销售的商品或服务，
请等待支付宝工作人员联系您
网银支付
商家填写的信息不符合网银支付申请要求，请核
对要求后重新申请，查看申请要求
担保买卖专业版
商家填写的信息不符合担保买卖专业版申请要求，
请核对要求后重新申请，查看申请要求
商家未申请支付宝接口收款类产品，无法直接申
请快捷登录
快捷登陆
商家申请的套餐类产品中已包含快捷支付，请勿
重复申请
支付宝账户内大
额收付款
商家不符合支付宝账户内大额收付款申请要求，
请核对要求后重新申请，查看申请要求
批量付款到支付
宝账户
商家不符合商户网端大额收款申请要求，请核对
要求后重新申请，查看申请要求
非证书余额支付
商家不符合非证书余额支付申请要求，请核对要
求后重新申请，查看申请要求
商户网端大额收
款
商家不符合商户网端大额收款申请要求，请核对
要求后重新申请，查看申请要求
用户身份信息验
证
商家不符合用户身份信息验证申请要求，请核对
要求后重新申请，查看申请要求
COD 货到付款平
台
商家不符合 COD 货到付款申请要求，请核对要求
后重新申请，查看申请要求
产品不
符合准
入标准
集分宝批量自助
发
商家不符合集分宝批量自助发申请要求，请核对
要求后重新申请，查看申请要求
其他 其他 慈善、公益募捐类网站暂不支持商家自助签约
例如：
网址问题/无效网址：网站提示存在风险，请您确认后重新申请本服务。
修改建议：该网站再审核中由于搜狗浏览器提示存在风险，说明该网址或网站信
息已被列入黑名单，因此建议您联系该浏览器的人确认无问题后，重新提交订单
审批。
解决办法：在该提示框左下方点击提交“网站申诉”，等待处理结果，去除后即可
重新提交支付宝订单。（截图如下）
如何修改被退回的订单？
2012 年 01 月 29 日【字号：大 中 小】【打印】【收藏】
订单审核退回，均会有短信及邮件通知（前提要开通通知功能，且预留的邮箱及
手机号码均真实有效），从退回之日起的 40 天内根据提示进行修改，否则订单
状态显示失效，需要重新提交签约。
退回原因大致分为以下三种：
1、网页链接问题：请点此查看！
2、网站所示商品问题：请点此查看！或者所选产品准入问题：请点此查看！
3、行业选择错误，需要确认修改后正确的行业选择！
操作如下所示：
1、先查看被退回的原因：
2、出现退回原因提示框，根据提示内容，点击修改申请信息，订单重新进入审
核环节。若不修改，则 40 天超时，订单失效，需要重新提交签约。
3、行业信息修改：
4、确认被修改的行业信息即可：直接进入审核环节，若不修改，则 40 天超时，
订单失效，需要重新提交签约。
5、确认同意修改行业信息后，订单直接进入待集成状态，集成分自助集成和帮
助集成（3 个工作日），集成完毕，订单状态显示生效：
订单审核需要多久时间？
2012 年 01 月 29 日【字号：大 中 小】【打印】【收藏】
订单提交进入审核中状态，如下图所示，请您耐心等待，审核时间为 3 个工作日
内处理。审核通过，进入一下个环节待集成状态。
什么情况下需要作废取消定单？
2012 年 01 月 29 日【字号：大 中 小】【打印】【收藏】
原订单提交错误，重新提交时提示起冲突，可以将原冲突的审核未通过的订单进
行取消操作：
三、技术集成
如何查询合作身份者 ID（partner）和交易安全校验码
（key）
2011 年 04 月 11 日【字号：大 中 小】【打印】【收藏】
合作者身份 ID（partner）和交易安全校验码（key）是商户与支付宝签约后，商
户获得的支付宝商户唯一识别码与密钥。当商户把支付宝功能接入商户网站时会
用到它们，以便让支付宝认证商户。
如何查询它们需要通过以下操作——
第一步：登陆支付宝官方网站（）。
第二步：点击导航栏中“商家服务”，找到“合作身份(Partner ID)查询”与“安全校验
码(key)查询”。
自助集成 帮助集成 测试上线 技术服务
第三步：点击“合作身份(Partner ID)查询”。
即可查询到合作者身份 ID，以 2088 开头的 16 位纯数字。
第四步：点击自助集成帮助中的“安全校验码(key)查询”
注意：要查询安全校验码须安装数字证书或支付盾。
第五步：在弹出的对话框中，输入“支付密码”，点击“确定”按钮。
即可查询到安全校验码 key，以数字和字母组合的 32 位字符。
支付宝接口如何集成？
2011 年 03 月 28 日【字号：大 中 小】【打印】【收藏】
当您的订单通过审核后，需要把支付宝的接口功集成至您的网站，这样您的网站
中才能通过支付宝收付款。
您有三种方式可以完成集成：
方式一：网店论坛系统帮助教程
如果您使用的网店如 SHOPEX、ECSHOP、HISHOP、V5SHOP、SHOPNC、乐
度、360、团购网、店掌柜、华众；或论坛系统如 DISCUZ、PHPWIND 等。则
您可根据网店或论坛系统的官方网站提供的帮助教程，找到支付管理，安装支付
宝插件，设置相关信息，就能够使您的网站集成支付宝。
方式二：申请支付宝协助集成
您可点此申请协助集成
提交申请后，支付宝小二会主动联系并及时处理。
方式三：自助集成
如果您有专业的网站程序开发或维护管理的技术人员，可下载支付宝的接口资料。
根据资料里的代码示例、技术文档、集成教程等，把程序代码集成到您网站。
点此下载技术支持文档
如果您依照自助集成方法无法解决，可提交协助集成申请，我们的技术支持会及
时与您联系，协助您解决。
如何在线申请技术帮助服务？
2012 年 01 月 21 日【字号：大 中 小】【打印】【收藏】
在线申请技术帮助有两种方式：在线提交表单和技术服务页面在线客服咨询。
1、打开 ，登陆签约的支付宝账户，选择技术服务，如下图所示：
2、选择页面最下方的申请技术支持，如下图所示：
3、填写表单进行提交，带星号的为必填写项，清楚填写您遇到的问题，以便更
快捷解决您遇到的问题，如下图所示：
4、提交后，支付宝会在 2 个工作日内进行处理，请保持电话畅通。
5、还可以通过技术服务页面右上角技术客服，在线旺旺进行技术咨询。在线服
务时间为每周一至周五的 9:00-18:00（节假日除外！
如何调试支付宝接口？
2010 年 12 月 16 日【字号：大 中 小】【打印】【收藏】
下载了支付宝的接口资料，按照资料设置好了支付宝的接口代码后，商户可
根据下面的步骤来调试支付宝的接口。
步骤
第一步：仅仅把接口配置好，不要放在网站项目中。在本机单独对这个接口
进行调试。调试内容包括支付、返回；
第二步：本机调试没有问题后，再放入服务器中调试。调试内容包括：支付、
返回、通知；
第三步：把调试好的接口与网站项目的下单流程进行衔接和融合；
第四步：在本机调试衔接到网站项目后的接口。调试内容包括：支付、返回；
第五步：本机调试没有问题后，再放入服务器中调试。调试内容包括：支付、
返回、通知；
支付
第一步：保证订单号（out_trade_no）的唯一性，不要有重复的订单号出现。
第二步：若包含下单流程，须购买一件商品，商品设定的金额 元，下
单完成。订单总额用 元做支付测试。
第三步：访问 index 文件（如：本机路径是：http://localhost/接口文件夹名
/；服务器上路径是：http://网站域名/接口文件夹名/）。
第四步：点击支付宝付款的按钮，页面会跳转至支付宝收银台；
第五步：在支付宝的收银台里，点击“确认无误，付款”，完成支付宝里的付
款操作。
返回
第一步：在支付宝收银台里，完成付款操作，支付宝页面显示付款成功，如
图：
第二步：等待几秒，页面自动跳转到返回页面（参数 return_url 对应的路径
地址），查看返回的页面是否打印出返回的数据，根据返回的数据来判定是验证
失败还是成功。
如果验证失败，
分步一：检查 return_url 的路径是不是对的
分步二：断点调试或用写日志函数记录代码执行情况
分步三：检查程序运行到 alipay_notify 文件的 return_verify()函数中的
mysign = request. QueryString ("sign") and responseTxt = "true"（PHP 代码示范：
preg_match("/true$/i",$veryfy_result) && $this->mysign == $_GET["sign"]）这里时，
是哪个判断出了问题。
第三步：断点调试或用写日志函数 log_result()记录数据库程序代码段的执行
情况。
通知
第一步：确定服务器是否开启写入权限。
第二步：服务器的 IP 地址是否有做过更换，详细可参考：
第三步：必须把接口放置在服务器里做调试；
第四步：notify_url 的路径互联网上可以访问得到，且只显示 fail。其他如空
白或是程序错误提示等内容，均属程序执行出错；
第五步：付款完成一次 1 分钱的交易；
第六步：用写日志函数 log_result()记录检查程序运行到 alipay_notify 文件的
return_verify()函数中的 mysign = request. QueryString ("sign") and responseTxt =
"true"（PHP 代码示范：preg_match("/true$/i",$veryfy_result) && $this->mysign ==
$_GET["sign"]），这两个判断的执行结果
第七步：用写日志函数 log_result()记录数据库程序代码段的执行情况；
第八步：用写日志函数 log_result()记录整个页面打印出来的信息是否只有
success。
如果您依照以上方法还无法解决，可提交集成申请，我们的技术支持会及时
与您联系，协助您解决。
申请地址：
常见错误代码总汇表
2012 年 01 月 29 日【字号：大 中 小】【打印】【收藏】
错误代码 说明
EXPARTNER_INFO_UNCORRECT 传入外部商户接口信息不正确
TRADE_BUYER_NOT_MATCH 买家账户与交易中不一致
TRADE_SELLER_NOT_MATCH 卖家账户与交易中不一致
TRADE_DATA_NOT_MATCH 请求数据与交易中不一致
SELLER_NOT_IN_SPECIFIED_SEL
LERS
卖家不在指定的商户限制卖家
中
ILLEGAL_SIGN 签名验证出错
ILLEGAL_ARGUMENT 输入参数有错误
HASH_NO_PRIVILEGE 没有权限访问该服务
ILLEGAL_SERVICE service 参数不正确
ILLEGAL_PARTNER 合作身份者 ID 不正确
HAS_NO_PUBLICKEY 没有上传公钥
USER_NOT_EXIST 会员不存在
OUT_TRADE_NO_EXIST 外部交易号已经存在
TRADE_NOT_EXIST 交易不存在
ILLEGAL_PAYMENT_TYPE 无效支付类型
BUYER_NOT_EXIST 买家不存在
SELLER_NOT_EXIST 卖家不存在
BUYER_SELLER_EQUAL 买家、卖家是同一帐户
ILLEGAL_SIGN_TYPE 签名类型不正确
COMMISION_ID_NOT_EXIST 佣金收取帐户不存在
COMMISION_SELLER_DUPLICAT
E
收取佣金帐户和卖家是同一帐
户
COMMISION_FEE_OUT_OF_RANG
E
佣金金额超出范围
ILLEGAL_LOGISTICS_FORMAT 无效物流格式
TOTAL_FEE_LESSEQUAL_ZERO 交易总金额小于等于 0
TOTAL_FEE_OUT_OF_RANGE 交易总金额超出范围
ILLEGAL_FEE_PARAM
非法交易金额格式（参考单价、
总价、数量三个组合规则）
DONATE_GREATER_THAN_MAX
小额捐赠总金额超出最大值限
制
DIRECT_PAY_AMOUNT_OUT_OF_
RANGE
快速付款交易总金额超出最大
值限制
DIGITAL_FEE_GREATER_THAN_
MAX
虚拟物品交易总金额超出最大
值限制
SELF_TIMEOUT_NOT_SUPPORT 不支持自定义超时
COMMISION_NOT_SUPPORT 不支持佣金
VIRTUAL_NOT_SUPPORT 不支持虚拟収货方式
ILLEGAL_DYN_MD5_KEY 动态密钥信息错误
ILLEGAL_ENCRYPT 加密不正确
ILLEGAL_USER 用户 ID 不正确
ILLEGAL_EXTERFACE 接口配置不正确
ILLEGAL_PARTNER_EXTERFACE 合作伙伴接口信息不正确
ILLEGAL_SECURITY_PROFILE 未找到匹配的密钥配置
ILLEGAL_AGENT 代理 ID 不正确
ILLEGAL_CHARSET 字符集不合法
ILLEGAL_CLIENT_IP 客户端 IP 地址无权访问服务
SYSTEM_ERROR 支付宝系统错误
SESSION_TIMEOUT session 超时
ILLEGAL_DIGEST_TYPE 摘要类型不正确
ILLEGAL_DIGEST 文件摘要不正确
ILLEGAL_FILE_FORMAT 文件格式不正确
ILLEGAL_TARGET_SERVICE 错误的 target_service
ILLEGAL_ACCESS_SWITCH_SYST
EM
partner 不允许访问该类型的系
统
ILLEGAL_SWITCH_SYSTEM 切换系统异常
ILLEGAL_ENCODING 不支持该编码类型
EXTERFACE_IS_CLOSED 外部接口已关闭
ILLEGAL_REQUEST_REFERER 防钓鱼检查不支持该请求来源
ILLEGAL_ANTI_PHISHING_KEY 防钓鱼检查非法时间戳参数
ANTI_PHISHING_KEY_TIMEOUT 防钓鱼检查时间戳超时
ILLEGAL_EXTER_INVOKE_IP 防钓鱼检查非法外部调用 IP
如果您依照以上方法还无法解决，可提交集成申请，我们的技术支持会及时
与您联系，协助您解决。
申请地址：
买家手动关闭了返回页面，交易订单如何更新？
2012 年 01 月 21 日【字号：大 中 小】【打印】【收藏】
原因：
买家支付完成后，当前界面会停留在支付宝的交易付款成功的提示界面上，如：
该页面有短暂的停留时间，买家看到这个提示信息后有可能会把当前页面关掉，
导致页面没有自动跳转回商户网站（return_url）使得商户的业务数据没有被处理
（如：订单没有更新）。出现这种情况的原因是：商户网站的支付宝接口并没有
利用服务器异步通知页面文件（notify_url）或是该页面在订单执行过程中也出现
异常。
解决方法：
解决人员：商户网店开发、维护或管理的程序开发技术人员、商户网店系统提供
商
解决步骤：
1、打开 return_url 页面文件（参数参数 return_url 对应返回文件），找到已经编
写好的业务逻辑处理程序代码段，对其增加防止该笔交易被重复处理判断。
2、打开 notify_url 页面文件（参数参数 notify_url 对应返回文件），找到可插入
商户的业务逻辑处理程序代码的地方，编写与 return_url 页面文件中相类似的程
序，也需要包含防止该笔交易被重复处理的判断。
修改完成后效果：
当买家关掉自动跳转回商户网站的返回页面（参数 return_url 对应的 return_url 返
回文件）时，商户的业务处理依旧被 notify_url 页面文件所执行，因此就不会发
生业务没有同步的现象出现（如：订单没有被更新）
注意：
1、注意获取值的方式，notify_url 页面文件是 POST 方式获取（（"
参数名 "）、$_POST['参数名']），return_url 页面文件是 GET 方式获取
（（"参数名 "）、$_GET['参数名']）
2、notify_url 文件的特性是：
1、 必须保证服务器异步通知页面（notify_url）上无任何字符，如空格、HTML
标签、开发系统自带抛出的异常提示信息等；
2、 该页面中获得参数的方式，需要使用 POST 方式获取，如：
（“out_order_no”）、$_POST['out_order_no']；
3、 支付宝主动发起通知，该方式才会被启用；
4、 只有在支付宝的交易管理中存在该笔交易，且发生了交易状态的改变，支付
宝才会通过该方式发起服务器通知（即时到账中交易状态为“等待买家付款”的状
态默认是不会发送通知的）；
5、 服务器间的交互，不像页面跳转同步服务器异步通知页面可以在页面上显示
出来，这种交互方式是不可见的；
6、 第一次交易状态改变（即时到账中此时交易状态是交易完成）时，不仅页面
跳转同步通知页面会启用，而且服务器异步通知页面也会收到支付宝发来的处理
结果通知；
7、 程序执行完后必须打印输出“success”（不包含引号）。如果商户反馈给支付
宝的字符不是 success 这 7 个字符，支付宝服务器会不断重发通知，直到超过 24
小时 22 分钟。
在 25 小时内完成 6~10 次通知（通知频率：5s,2m,10m,15m,1h,2h,6h,15h）；
8、 程序执行完成后，该页面不能执行页面跳转。如果执行页面跳转，支付宝会
收不到 success 字符，会被支付宝服务器判定为该页面程序运行出现异常，而重
发处理结果通知；
9、 cookies、session 等在此页面会失效，即无法获取这些数据；
10、 该方式的调试与运行必须在服务器上，即互联网上能访问；
11、 该方式的作用主要防止订单丢失，即页面跳转同步服务器异步通知页面没
有处理订单更新，它则去处理；
12、 通知 ID（参数 notify_id）只有一分钟有效期，超过一分钟该次通知会验证
失败。一旦验证成功下次再验证就会失效。
"如果您依照以上方法还无法解决，可提交集成申请，我们的技术支持会及时与
您联系，协助您解决。
申请地址：
商家后台为什么没有收到交易通知？
2012 年 01 月 21 日【字号：大 中 小】【打印】【收藏】
原因：
通知页面文件（参数 notify_url 对应的页面文件）由于程序抛出异常、页面文件
无法访问等原因致使通知页面中的程序没有执行完毕
检查方法：
检查服务器异步通知页面（参数 notify_url 对应的页面文件）
第一步： 检查 notify_url 页面文件
A：合作身份者 ID 和安全校验码是否设置正确，且没有空格，没有填反。
B、notify_url 的路径互联网上需要能够访问得到，确保访问到该页面时，页面没
有为空白或开发软件自带系统提示错误信息
C、请求参数 show_url、return_url、notify_url 不要带自定义参数，如：
?id=123，“？”以后带的参数都是自定义参数
D、检查编码格式是否设置正确
检查乱码的方法，可用写日志函数来记录中文部分的数据是否乱码。如果乱码则
确定是编码格式设置不一致，导致乱码。具体请检查编码格式参数
input_charset、页面属性编码、网站项目整体编码等，确保传递数据时没有乱码。
E、notify_url 页面里，有且只有输出 success，且必须保证为空白页面，无任何
HTML 标签、空格、回车换行等字符。
各开发语言输出 success 代码：
：("success");
ASP： "success"
PHP：echo "success";
JAVA：("success");
F、notify_url 页面中不要有 seesion 或 cookies，不要做页面自动跳转
第二步： 检查服务器配置（以下为参考检查方向）
A、服务器是否开启写入权限
B、DNS 解析，是否能够解析支付宝 IP。
C、防火墙是否有拦截
D、端口 443 或 80 是否有开启，且不是假死状态，也没有被占用
E、 服务器的 IP 地址是否有做过更换，如果有做过更换，则请把 notify_url 页面
文件重命名，参数 notify_url 的值也一并更新。
第三步： 调试
A、检查程序运行到 alipay_notify 文件的 notify_verify()函数中，在 mysign 与 sign
是否相等的判断与 responseTxt 是否为 true（PHP 代码：$veryfy_result）的判断
这两个判断上是哪个判断验证未通过。
sign 与 mysign 不等的情况有：
安全校验码（参数 key）设置有错误、参数格式设置错误与编码乱码（见第一步）
responseTxt 不是 true 的情况有：
合作身份者 ID（参数 partner）设置有错误、服务器配置（见第二步）、页面跳
转返回的地址栏里的链接超过 1 分钟的有效时间
B、在调试 notify_url 页面时，必须把接口放置在服务器里做调试
C、检查程序运行到商户网站自己编写的业务逻辑处理程序代码段时，断点调试
或使用写日志函数（函数名：log_result）逐行检查代码，监控各个参数变量
注意：
商户网站中对这笔交易做了多次处理（如付了一次钱，却反复充值多次）这类情
况，按照解决方法修正了商户网站的程序或服务器后，请务必在页面跳转同步通
知页面文件（return_url）与服务器异步通知页面文件（notify_url）中，在商户的
业务逻辑处理的程序代码执行之前，一定要先判断该次处理是否已经被做过相同
的处理（即，该笔交易在已经付过款后，商户网站里的订单是否已经做过订单更
新），如：是否已经为会员充值过一次。没有做过相同的处理，才执行下面的程
序。
"如果您依照以上方法还无法解决，可提交集成申请，我们的技术支持会及时与
您联系，协助您解决。
申请地址：
为什么支付宝不断的发通知？
2011 年 07 月 08 日【字号：大 中 小】【打印】【收藏】
原因：
这种情况商户网站的订单有时、有部分订单会更新成功，有时有部分会更新失败。
出现这种情况是因为通知页面文件（参数 notify_url 对应的页面文件）程序在执
行过程中为执行完毕、程序抛出异常，使得支付宝服务器未收到或收到的不是商
户提交过来的 success7 个字符的成功标识。
检查方法：
检查服务器异步通知页面（参数 notify_url 对应的页面文件）
第一步： 检查 notify_url 页面文件
A：合作身份者 ID 和安全校验码是否设置正确，且没有空格，没有填反。
B、notify_url 的路径互联网上需要能够访问得到，确保访问到该页面时，页面没
有为空白或开发软件自带系统提示错误信息
C、请求参数 show_url、return_url、notify_url 不要带自定义参数，如：
?id=123，“？”以后带的参数都是自定义参数
D、检查编码格式是否设置正确
检查乱码的方法，可用写日志函数来记录中文部分的数据是否乱码。如果乱码则
确定是编码格式设置不一致，导致乱码。具体请检查编码格式参数
input_charset、页面属性编码、网站项目整体编码等，确保传递数据时没有乱码。
E、notify_url 页面里，有且只有输出 success，且必须保证为空白页面，无任何
HTML 标签、空格、回车换行等字符。
各开发语言输出 success 代码：
：("success");
ASP： "success"
PHP：echo "success";
JAVA：("success");
F、notify_url 页面中不要有 seesion 或 cookies，不要做页面自动跳转
第二步： 检查服务器配置（以下为参考检查方向）
A、服务器是否开启写入权限
B、DNS 解析，是否能够解析支付宝 IP。
C、防火墙是否有拦截
D、端口 443 或 80 是否有开启，且不是假死状态，也没有被占用
E、 服务器的 IP 地址是否有做过更换，如果有做过更换，则请把 notify_url 页面
文件重命名，参数 notify_url 的值也一并更新。
第三步： 调试
A、检查程序运行到 alipay_notify 文件的 notify_verify()函数中，在 mysign 与 sign
是否相等的判断与 responseTxt 是否为 true（PHP 代码：$veryfy_result）的判断
这两个判断上是哪个判断验证未通过。
sign 与 mysign 不等的情况有：
安全校验码（参数 key）设置有错误、参数格式设置错误与编码乱码（见第一步）
responseTxt 不是 true 的情况有：
合作身份者 ID（参数 partner）设置有错误、服务器配置（见第二步）、页面跳
转返回的地址栏里的链接超过 1 分钟的有效时间
B、在调试 notify_url 页面时，必须把接口放置在服务器里做调试
C、检查程序运行到商户网站自己编写的业务逻辑处理程序代码段时，断点调试
或使用写日志函数（函数名：log_result）逐行检查代码，监控各个参数变量
注意：
商户网站中对这笔交易做了多次处理（如付了一次钱，却反复充值多次）这类情
况，按照解决方法修正了商户网站的程序或服务器后，请务必在页面跳转同步通
知页面文件（return_url）与服务器异步通知页面文件（notify_url）中，在商户的
业务逻辑处理的程序代码执行之前，一定要先判断该次处理是否已经被做过相同
的处理（即，该笔交易在已经付过款后，商户网站里的订单是否已经做过订单更
新），如：是否已经为会员充值过一次。没有做过相同的处理，才执行下面的程
序。
"如果您依照以上方法还无法解决，可提交集成申请，我们的技术支持会及时与
您联系，协助您解决。
申请地址：
如何在线申请技术帮助服务？
2012 年 01 月 21 日【字号：大 中 小】【打印】【收藏】
在线申请技术帮助有两种方式：在线提交表单和技术服务页面在线客服咨询。
1、打开 ，登陆签约的支付宝账户，选择技术服务，如下图所示：
2、选择页面最下方的申请技术支持，如下图所示：
3、填写表单进行提交，带星号的为必填写项，清楚填写您遇到的问题，以便更
快捷解决您遇到的问题，如下图所示：
4、提交后，支付宝会在 2 个工作日内进行处理，请保持电话畅通。
5、还可以通过技术服务页面右上角技术客服，在线旺旺进行技术咨询。在线服
务时间为每周一至周五的 9:00-18:00（节假日除外！
四、推广续签
什么是商家活动？
2012 年 01 月 21 日【字号：大 中 小】【打印】【收藏】
商家活动是由活动专题的形式推出，商家可以挑选并报名预定商品展示位，
经支付宝审核预定成功后，可将商家的促销商品整合成一个专题活动。买家通过
点击支付宝网站内的活动广告访问活动页面。商家通过参加商家活动，可获得更
多买家和更多交易量。
支付宝微客平台商家使用手册
2011 年 04 月 06 日【字号：大 中 小】【打印】【收藏】
商家推广 活动报名 到期续签 到量续签
1、打开网页：
2、点击页面右上角“我是商家” 。
3 如果您还没有入驻支付宝微客平台，请点击按钮“点击立马入驻” 。
4、点击“立马入驻后”，请务必真实准确填写以下商家信息，便于后期审核通过。
填写完毕后，请勾选“已问读并同意”，并点击“下一步” 。
5、请输入支付宝登录密码，以便验证您的支付宝帐号有效。
6、支付宝微客入驻成功！您可以发布消费券活动啦！
7、 如果您已入驻支付宝微客，请直接点击“登录”按钮。
8、填写您的“支付宝帐户名”及“支付宝登录密码”，点击“确认”。或者，您也可
以用您的微博帐号登录微客。
9、登录微客后，在您发布消费券前，建议您先点击“关联社区账户”，将您的支
付宝账户和新浪微博账户进行绑定。
10、选择您要关联帐号的社区。
11、输入您要关联的社区帐号和密码，点击“授权”，完成账户绑定。
12、社区账户关联成功！
13、好了！现在介绍如何发布消费券了！请点击“发布消费券”按钮。
14、按照提示，认真填写消费券相关信息。请在“导入卡密”部分，点击“导入”按
钮，以 excel 格式，导入您的消费券卡密（或卡号+卡密）。
如果您没有消费券生成系统，可以先登录支付宝，生成支付宝红包，将支付宝红
包的卡号和卡密导入微客。（支付宝红包使用流程详见：
消费券信息填写完毕后，即可编辑活动微博，并点击“提交审核”发布。
15、提交审核后，请等待审核通过。支付宝会在 3-7 个工作日内反馈审核结果。
如需查询审核情况，或跟踪和管理消费券活动信息，请点击“进入管理页面”：
16、消费券经审核通过发布成功后，就会生成一个消费券详情页，以及一条对应
的微博。消费者可点击微博上的购买链接，进入消费券详情页，点击“购买“按钮，
就可领取你家的消费券啦！
商家如何入驻接入一淘（etao）？
2012 年 01 月 21 日【字号：大 中 小】【打印】【收藏】
一淘入驻入口有：，以及 两个页面申请入口，以
下申请以后者为例：
1、进入一淘开放搜索页面（）点击“立刻入驻”。
2、了解入驻要求，点击“我已了解，开始入驻”进入下一步
3、提交域名
1） 填写网站域名和邮箱，*代表必填信息。输入验证码后点击“提交”。
2） 点击提交后，提示发送了确认信到填写的邮箱里。
3） 若网站域名已被占用，则提示“提交的域名已被占用”
可能的原因：
已提交过该域名，并已提交过基本资料审核；
其他人已经申请过该域名，已是一淘收录的商家。
4、验证域名
验证域名的目的：该网站是否真实；该网站是否是申请人所有。
1） 验证域名邮件
2） 点击邮件里的链接，进入到验证域名的页面
3） 根据上图中的 步骤，先下载专用的验证文件。该文件是一个 txt 文件，
内容包括一串验证码，如下图：
4） 将验证文件上传到申请的域名指向的 web 服务器的根目录，例如
，确保通过该链接能访问到上图中
那串验证码，如下图：
5） 若能访问该验证码，则点击“立刻验证”后，验证成功，如下图：
同时收到验证通过邮件：
点击上图中邮件的链接，则进入下一步基本资料填写。
若不能访问验证码，则点击“立刻验证”后，验证失败，如下图：
并收到验证失败邮件，如下图：
点击上图邮件中的链接则返回验证域名的页面，重新验证。
可能的原因：
将验证文件放错位置，应放在根目录下，确保能通过上图 步骤中的地址访问
到同验证文件中相同的代码，即可验证成功。
5、填写基本资料
1）点击验证通过邮件中的链接，进入到基本资料填写页面；
2）请注意按照说明正确的信息以确保基本资料审核通过
账户名称在商城名称后面加“官网”，例如“麦包包”是商城名称，则账户名称为“麦
包包官网”；
账户名称字数控制在 10 字以内，不能有大写字母，且必须是对外宣称的网站名
称。
填写正确的 ICP 备案号，确保真实且有效；
带*的地方是必须填写选项。
3） 若基本资料全部填写完毕，则点击下一步，可提示完成申请：
并收到邮件提示基本资料提交成功。
4）小二将审核基本资料，若通过，则收到邮件如下：邮件中会告诉商家在一淘
开放平台的账号和密码，并可通过邮件中的链接修改密码或者进入一淘开放平台
若未通过，则收到邮件如下：其中小二会将未通过的原因写在邮件中。
点击邮件中的链接，可回到基本资料填写页面重新填写并提交。
在哪里报名关注商家活动？
2012 年 01 月 21 日【字号：大 中 小】【打印】【收藏】
1、打开 ，选择营销推广，登陆支付宝账户，可报名参加现有推
出的活动申请，如下图所示：
2、或者打开 ，登陆支付宝账户-商家服务-商家活动，可报名参
加现有推出的活动申请，如下图所示：
参加活动的商品有些什么要求？
2012 年 01 月 21 日【字号：大 中 小】【打印】【收藏】
只要是支付宝签约商家，任何非违禁商品均可参加报名。支付宝违禁商品说
明（点此查看）
什么是到期续签？
2012 年 01 月 21 日【字号：大 中 小】【打印】【收藏】
到期续签：签约订单均为一年的有效期，分别会在到期前 45 天、30 天、20
天、10 天时会有邮件或者短信通知（前提要开通通知功能，且预留的邮箱及手
机号码均真实有效）提醒续签。成功续签后，续签的新订单会自动生效，原订单
到期自动作废。
如何查询订单生效及到期时间？
2012 年 01 月 21 日【字号：大 中 小】【打印】【收藏】
1、从 登录，我的商家服务—选择“我的产品”（默认我的订
单），直接显示有效期，或者点击您想查看的产品“详情”，如下图所示：
2、即可查看生效及到期时间，商家根据到期情况适时提前进行续签。如下图所
示：
什么是量到续签？
2012 年 01 月 21 日【字号：大 中 小】【打印】【收藏】
量到续签：签约的是包量的预付费产品。用量为分别到达 70%、80%、
90%、95%时会有邮件或者短信通知（前提要开通通知功能，且预留的邮箱及手
机号码均真实有效）提醒续签。量到续签的订单，当量到了之后，会自动切换到
新的签约生效订单费率内计费，原订单自动作废。量到了，如果没有进行续签，
超量的部分会按照默认的费率进行收费。
如何查询包量订单已使用的流量？
2012 年 01 月 21 日【字号：大 中 小】【打印】【收藏】
1、从 登录，我的商家服务—选择“我的产品”（默认我的订单），
点击您想查看的产品“详情”，如下图所示：
2、即可看到流量使用情况，商家根据自己流量的使用情况，预估到量时间适时
进行续签。如下图所示：
如何进行量到续签操作？
2012 年 01 月 29 日【字号：大 中 小】【打印】【收藏】
用量为分别到达 70%、80%、90%、95%时会有邮件或者短信通知（前提要
开通通知功能，且预留的邮箱及手机号码均真实有效）提醒续签。
续签操作如下：
1、如果续签原产品，则登陆 页面直接弹跳出续签提示框，如下图
所示：
2、若不小心将此页面关注，也可以直接选择商家服务—我的产品—企业信息栏
下点续签：
3、确认续签的产品名称、支付宝账户提交进入审核环节，审核时间为 3 个工作
日，请您耐心等待，审核通过显示为生效状态。
4、若您需要续签约的产品已经停止销售或者想更改续签的产品类型，则可以拨
打商家服务专线 0571-88158090，由人工为您提供服务。
