接入与使用规则
移动支付接口 SDK2.0 标准版
附录文档
版本号:1.2
支付宝(中国)网络技术有限公司 版权所有
移动支付接口 SDK2.0 标准版附录文档
支付宝(中国)网络技术有限公司 版权所有| 版本:1.2 第 2 页
目 录
1 文档说明 .............................................................................................................. 4
1.1 文档说明 ............................................................................................................................... 4
1.2 业务术语 ............................................................................................................................... 4
2 责任归属 .............................................................................................................. 4
3 技术接入规则 ....................................................................................................... 5
4 接入流程 .............................................................................................................. 7
4.1 接入总流程 ........................................................................................................................... 7
4.2 通知规则 ............................................................................................................................... 7
4.2.1 不可退款的移动快捷支付 ........................................................................................... 7
4.2.2 可退款的移动快捷支付 .............................................................................................. 7
5 集成流程详解 ....................................................................................................... 8
5.1 接入前期准备 ........................................................................................................................ 8
5.2 SDK 集成流程 ....................................................................................................................... 8
5.2.1 IOS ............................................................................................................................. 8
5.2.2 Android ..................................................................................................................... 16
6 测试流程规则 ..................................................................................................... 20
7 附录 ................................................................................................................... 21
7.1 如何获得 PID 与密钥 .......................................................................................................... 21
7.2 RSA 密钥生成与使用 .......................................................................................................... 23
7.2.1 生成商户密钥 ........................................................................................................... 23
移动支付接口 SDK2.0 标准版附录文档
支付宝(中国)网络技术有限公司 版权所有| 版本:1.2 第 3 页
7.2.2 RSA 密钥使用逻辑 ................................................................................................... 27
7.3 业务数据传递 ...................................................................................................................... 29
移动支付接口 SDK2.0 标准版附录文档
支付宝(中国)网络技术有限公司 版权所有| 版本:1.2 第 4 页
1 文档说明
1.1 文档说明
本文档是《移动支付接口 SDK2.0 标准版》附录文档,它详细解释了在技术接入与
使用过程中需要注意的地方,以帮助商户避免风险产生。
阅读后如有疑问,请联系支付宝相关技术支持。
1.2 业务术语
表1-1 业务术语
术语 解释
请求 手机客户端以字符串形式把需要传输的数据发送给接收方的过程。
返回 支付宝以字符串形式直接把处理结果数据返回给手机客户端。
通知
服务器异步通知。支付宝根据得到的数据处理完成后,支付宝的服务器主动发起通知给商户
的网站,同时携带处理完成的结果信息反馈给商户网站。
敏感词 带有敏感政治倾向、暴力倾向、不健康色彩或不文明的词。
2 责任归属
文档中所涉及到的规则都是根据在接入与使用支付宝接口的过程中出现的一些主
要风险而做的防范措施,请商户予以关注。请在接入及使用支付宝接口的过程中,
严格依照支付宝提供的接口技术文档(移动支付接口 SDK2.0 标准版.pdf)、代码
示例、本文档(移动支付接口 SDK2.0 标准版接入与使用规则)等接口资料,否则
由此导致的风险以及资金损失或者扩大情形需商户自行承担。
移动支付接口 SDK2.0 标准版附录文档
支付宝(中国)网络技术有限公司 版权所有| 版本:1.2 第 5 页
3 技术接入规则
表3-1 技术接入规则
类型 细则 原因
账号
配置的合作者身份 ID 与安全校验码 key 必须保证与签
约信息匹配
防止接口无法正常使用或出现资
金损失
必须保护合作者身份 ID 与安全校验码 key 的隐私性
防止签约的账号信息被盗用,导致
资金受损、被他人恶意利用等。
测试完毕后,要把测试账号立刻更换成签约账号。
使用测试账号时,手续费按照 3%
扣除。
安全
商户必须以 DNS 解析的方式访问支付宝接口,不要设
置 DNS cache,不要绑定支付宝 IP。如果为了商户自
身安全必须绑定支付宝 IP 时,必须向支付宝的技术支
持人员备案。
支付宝 IP 地址一旦变更,会导致
商户无法请求或访问支付宝,致使
商户业务直接不可用。
签名
在对请求的参数做签名时,这些参数必须来源于请求参
数列表,并且除去列表中的参数 sign、sign_type。
避免接口无法正常使用
在对请求的参数做签名时,对于请求参数列表中那些可
空的参数,如果选择使用它们,那么这些参数的参数值
必须不能为空或空值。
避免报异常错误,各种错误码需参
考错误码列表
参数配置
在请求参数列表中,不可空的参数必须配置。 避免接口无法正常使用
在请求参数列表中,可空的但需要多选一的多个参数
中,必须配置至少一个。
避免接口无法正常使用
必须按照请求参数列表中各参数的格式要求配置 避免接口无法正常使用
必须设置请求参数_input_charset(编码格式),即该
参数不能为空,并让该参数加入签名运算。而且只能设
置其值为 utf-8,即本产品不支持 GBK 编码格式。
避免报异常错误,如:签名不正确。
seller 是收款时的支付宝账号,需要与 partner 对应的
支付宝账号为同一个,也就是说收款支付宝账号必须是
签约时的支付宝账号。
避免签约支付宝账号出现资金受
损的可能
签名方式仅支持 RSA 避免签名不成功
pkcs8 编码
移动快捷支付要求商户私钥需要做 pkcs8 编码以支持
更高手机系统版本,php 服务器可不需要做。
调用 RSA 密钥时,如果是通过
pem 文件解析方式,则无需 pkcs8
编码。