说明
本文档基于支付宝开放平台20190617版本修订。
1. 创建服务商支付宝应用
1. 登录 支付宝开放平台,选择开发者中心,选择第三方应用,进入创建第三方应用页面。n
2. 单击第三方应用页面左上角自定义接入-接入平台能力商家,开始创建应用。n
2. 添加功能
注意
应用的名称和图标不能和支付宝的一些应用有类似或重名,否则可能会被拒。
3. 添加“获取会员信息”
4. 添加“当面付”
5. 添加“第三方应用授权”
6. 添加“口碑开店”
如果服务商需要配置口碑门店的话,需要添加“口碑开店”功能,如下所示:n
7. 添加“无资金商户优惠券”
用于获取口碑门店列表。n
8. 设置授权回调地址
选择开发中心 > 开发配置 > 授权回调地址,单击设置首次填写时,可任意填写一个符合支付宝要求的域名。然后单击确定提交申请,审核通过之后,修改成
https://cashier.qcloud.com/cashier/ali_auth
。注意
符合支付宝要求的域名:例如
https://www.dennisxdu.com/ali_server/auth
。1. 此域名不能为知名域名,例如 qq.com、baidu.com、qcloud.com。
2. 此域名至少要有一层目录,例如 /ali_auth。
不要一开始就填写
https://cashier.qcloud.com/cashier/ali_auth
这个域名,否则可能不会通过申请。如果配置完支付宝开放平台和云支付后台服务商支付宝信息后,授权时,仍然出现“支付宝授权回调域名与支付宝后台设置不一致”的提示,请删除云支付后台服务商支付宝信息(选择编辑 > 删除应用 id > 保存),并重新填写。n
9. 生成支付宝应用验签公钥和签名私钥
1. 从 支付宝 下载支付宝密钥生成工具。n
2. 解压密钥生成工具,运行工具。n
3. 选择参数,并生成支付宝应用验签公钥和签名私钥(请选择 PKCS1 和2048)。n
4. 查看支付宝应用验签公钥和签名私钥。
说明
上图中的“应用公钥”就是需要上传到支付宝开放平台应用详情“应用公钥”,如果在商户授权时出现“云支付应用签名私钥和支付宝平台应用公钥不匹配”的提示时,就有可能是应用公钥上传错误。
“应用私钥”就是要上传到云支付-服务商详情-支付宝信息-“支付宝应用签名私钥”,如果出现“支付宝应用签名私钥格式错误”,请检查密钥生成时是否选中“PKCS1 和2048”。
“支付宝验签公钥”,是在上传“应用公钥”到支付宝开放平台后,由支付宝生成的“支付宝公钥”,需要复制,并上传到云支付的对应位置。
10. 上传支付宝应用验签公钥到支付宝开放平台
设置应用公钥后,可查看支付宝公钥。n
注意
新版本加签方式有调整,要选择“公钥”模式。
11. 获取支付宝验签公钥
上传应用公钥后,查看支付宝验签公钥。
注意
“支付宝验签公钥”,是在上传“应用公钥”到支付宝开放平台之后,由支付宝生成的“支付宝公钥”,需要复制,并上传到云支付的对应位置。
12. 发布服务
单击完成配置,下一步,进入发布流程,具体步骤不做概述。n
13. 查看支付宝的服务商应用 ID(APPID)
14. 查看服务商的合作者身份 ID(PID)
注意
PID 直接决定支付宝流水返佣的支付宝账号,如果填错,返佣就会入错账户,支付宝不接受申述,一定要慎重。
选择账户中心 > 合作伙伴管理 > PID,即可查看服务商的合作者身份 ID。n
15. 上传服务商信息到云支付(添加服务商或修改服务商时录入)
1. 录入服务商应用 ID(APPID,第13步获得)到“服务商应用 ID”。
2. 录入支付宝应用签名私钥(第9步获得)到“支付宝应用签名私钥”。
3. 录入支付宝验签公钥(第11步获得)到“支付宝验签公钥”。
4. 录入合作者身份 ID(PID,第14步获得)到“合作者身份 ID”。
注意
服务商录入到云支付中的合作者身份 ID,必须已经和支付宝签约返佣协议,才可以拿到返佣。因此,请确认合作者身份 ID 正确,且已经签约返佣协议,否则无法拿到返佣,支付宝也不接受申述。
添加服务商时录入:n
修改服务商时录入:n
16. Q&A
1. 授权回调地址填写错误n如果在商户授权过程中出现如图所示错误提示,请参考 设置授权回调地址,修正服务商回调地址配置。n
2. 应用私钥错误n如果出现下图所示错误,请先确认:
根据 生成支付宝应用验签公钥和签名私钥 生成出来的应用公钥,是否有按照 上传支付宝应用验签公钥到支付宝开放平台 的要求,正常上传到支付宝开放平台。
根据 生成支付宝应用验签公钥和签名私钥 生成出来的应用私钥,是否有按照 上传服务商信息到云支付(添加服务商或修改服务商时录入)的要求,正常上传到云支付 > 服务商详情 > 支付宝信息。n
3. 支付宝公钥配置错误n如果出现如上图所示错误,请按照 获取支付宝验签公钥,查找到支付宝公钥,然后按照 上传服务商信息到云支付(添加服务商或修改服务商时录入)要求,上传到云支付对应位置(支付宝验签公钥)。n
4. 未授权接口错误n商户进入手机端商户后台门店管理,绑定支付宝口碑门店,显示商户未授权当前接口错误。请按照 添加“口碑开店”、添加“无资金商户优惠券” 进行修正,添加服务,保存立即生效,然后请商户重新进行授权。n