摘要由AI智能服务提供本文概述了与龙岩有容雷芳老师对接某电商金蝶云星空客户时，上线支付宝银企平台的经验总结。文章包括支付宝对公账户配置、PID与APPID获取、加签方式选择、签约功能说明等。此外，还详细介绍了金蝶系统与支付宝的对接步骤，包括支付宝商户维护、应用创建与配置、证书下载与配置等。同时，还提供了金蝶银企平台与星空的相关配置指南，并解答了常见问题，如支付端口号报错、接口购买数量等。文章最后列出了相关支付宝接口学习资料，供读者参考。
关键词：银企直联、支付宝、公网、投产正式环境、第三方支付
参考文档：
支付宝对公企业客服电话：4007585858
金蝶EAS-支付宝配置不完全指南-SW-200318.doc（本文包含该文档中内容，可直接查看本文即可）
金蝶系统配置手册_支付宝微信账户V2.0.doc（本文包含该文档中内容，可直接查看本文即可）
支付宝在线文档：https://opendocs.alipay.com/
更新日志：
20240728V1.0.0：初稿，投产正式环境使用说明
本文基于与龙岩有容雷芳老师一同对接某电商金蝶云星空客户，上线银企平台（支付宝）时做了经验总结，其中包含了雷老师及其同事现场对接客户总结实操指南，特此感谢雷老师提供现场总结文档（链接：支付宝银企平台配置）
由于涉及到第三方支付（支付宝、微信）总部能提供的文档有限，也欢迎大家结合实际对接中一起完善本文档。
特别注意：
支付宝没有测试环境，因此在测试环境测试时连的也是用户的真实账号，消耗的真金白银，一定要提醒用户测试完成后清除相关证书。
1.相关概念
前提：需要开通支付宝对公账户/企业支付宝
1.1PID：合作伙伴身份，支付宝商户签约账户ID
一个支付宝对公账号只有一个ID。
合作者身份 ID，是商家与支付宝签约后，商家获得的支付宝商家唯一识别码，以 2088 开头的 16 位数字组成。
支付宝官方文档链接：获取 PID - 支付宝文档中心 (alipay.com)
查询PID示例：
1.2APPID：应用ID，支付宝商户签约账户
一个支付宝对公账户设置多个第三方应用，即可以有多个APPID。
相当于应用的身份证号，是支付宝分配给开发者的应用 ID，一般需在应用创建后才可以获取。
需要注意的是：
不同于银行账户，支付宝同一个对公账户（PID）下可以挂多个应用（APPID），每个应用又可以签约不同的功能。
目前金蝶支持单个PID下挂1个APPID的情况，在指导客户申请支付宝功能时一定注意不要弄错。
支付宝官方文档链接：获取 APPID - 支付宝文档中心 (alipay.com)
1.3加签方式选择
和支付宝交互时，需要通过公钥或证书的方式进行加签。
（1）只有查询明细需求（仅有对账单需求）：使用公钥加签即可。
（2）如果需要查询余额、进行支付宝银企付款：需要选择证书方式加签。
支付宝官方文档链接：接口加签方式说明 - 支付宝文档中心 (alipay.com)
总结：
如果需要余额查询、明细查询、银企支付：一定要用证书方式加签。
本文讲解也主要从证书方式加签做说明。
1.4签约功能说明
转账到支付宝账户（余额查询、转账到支付宝账号）
如果客户还需要签约对账单查询，需要签约当面付 手机网站支付 电脑网站支付 APP支付四大支付产品中任意一个，需要注意会涉及费率，不过如果只用对账单应该没问题，需要客户和支付宝确认。
1.5总结
建议特别是对接N家公司支付宝账户时，建议整理一个Excel表，列头如下所示：
| 序号 | 公司 | 支付宝账户 | PID | APPID | 加签方式 | 证书加签对应5个附件存储在服务器的位置 | 开通功能列 |
| 示例 | xxx电子商务公司 | XXX@163.com | 公钥加签/证书加签 |
2.支付宝商户维护
2.1新建应用
登录支付宝网址：https://open.alipay.com/
登录后，点击控制台
新建应用，点击立即开发
确认创建后，支付宝大约会花1天左右时间审批，需要注意命名规范，否则可能会被打回。
审批通过的应用，会显示在列表中，应用下面的数字即为APPID（已打码）：
2.2配置应用相关参数
2.2.1下载密钥工具
下载密钥工具
2.2.2安装密钥工具
安装后会有一个【支付宝开放平台密钥工具】的图标
2.2.3下载密钥
选择证书方式
文件夹内的内容：
2.2.4配置接口加签方式
勾选同意签署，确认上传。
2.2.5接口内容加签方式
2.2.6服务器IP白名单配置（一定需要操作）
说明：这个是支付宝这里安全性检测到操作IP变动提示有风险的，要找客服解除这个风险提示限制，要提供公司相关信息申请解除，正常是24小时内通过，要快速通过就需客户申请该支付宝账号对应的法人扫脸验证通过。
2.2.7开发设置项提交审核
以上三项都已设置完成后，才能点击下方的提交审核。
说明：此处提交审核在24小时内通过审核
2.2.8开通转账到支付宝服务
切换到商家平台，开通【转账到支付宝账户】产品服务
根据实际情况和提示在本页面内选择经营类目，上传商铺照片提交申请，本次申请预计在24小时内通过审核。
2.2.9增加API接口-转账到支付宝账户
支付宝开放平台---API页面
2.2.10申请开发代码变更
这边提交申诉差不多要1-2天
申请成功后
2.2.11开通余额支付功能
说明：支付宝账户需有资金池账户功能的，才能开通余额支付功能，对应金蝶云星空付款支付才能通过银企对接调用支付宝支付功能。
资金池账户登录支付商家平台
开通过程需要提供手机验证码、支付密码等信息
2.2.12下载相关证书
配置完成后，需要下载相关证书
上面三个证书下载后，和前面的私钥证书一起打包进行后台配置处理。
前面私钥证书文件：
3.金蝶银企平台、星空相关配置
3.1前置机配置
按默认设置，点击保存。
3.2金蝶云星空支付宝账号设置
增加银行
增加支付宝账号
3.3银企平台支付宝账户附加属性维护
金蝶云星空点击【同步到银企平台】后，银企平台账号资料中会增加一个支付宝账户
上图数据来源：
A支付宝商户签约账号PID
登录支付宝开放平台，在账户中心的mapi网关产品密钥中可以查询到
B支付宝应用ID（APPID）
登录支付宝开放平台，在账户中心的应用密钥管理中可以查询到
C支付宝应用私钥
在支付宝应用申请过程中，申请接口加签方式时，用支付宝开放平台密钥工具下载CSR证书文件时，一起下载下来的文本文件中复制
D应用公钥证书路径、支付宝公钥证书路径、支付宝根证书路径
在支付宝应用申请过程中，申请接口加签方式通过审批后，下载的证书文件拷贝放到银企服务器的存放路径
3.3支付宝银企参数配置
3.4支付接口路由配置
3.5银企平台查询余额、交易明细
这一步是检查工作，在业务首页中查询对应的账户是否可以正常查询到余额和交易明细
交易明细，不能查询当天，查询之前一天的数据。
3.6后台调度配置建议
完成上述配置后，可在星空/EAS中进行支付宝付款及对账单测试。
需要注意支付宝查询交易明细的逻辑设计：仅提供T+1的对账单，即只能下载到前一天的对账单。所以建议是设置一个定时调度：每天中午12点查询前一天的明细。
如果查询范围是大于1天（即开始时间与结束时间不是同一天），银企平台不会发请求到支付宝，而是直接从数据库返回数据的，因此要查大于1天的时候，确保时间范围内的每一天都单独查询过1次明细。
定时调度配置（也可以在eas进行配置）：
登录银企平台，菜单系统管理-定时任务配置，新增对账单定时调度。
建议设置在中午12点，支付宝客服说早上10点左右才出前一天的对账单。
4.常见问题
4.1星空中支付宝银企支付付款单提交/审核时提示交易端口号为空（升级银企平台解决）
升级最新版本银企补丁（PT176874-20240709或以上版本）
已优化：支付宝推广版端口号取消非只读，防止云星空出现端口号为空的报错。
4.2如果银企支付需要对接支付宝，需要购买几个银企平台查询支付接口、几个电子回单接口？
结论：只需要一个查询与支付接口许可即可、不需要购买电子回单接口（因为目前暂不支持对接支付宝回单功能）
按目前配置来看，支付宝就是只买一个查询与支付接口就够用了，可以对接N个支付宝账号，每个支付宝账号单独设置应用和相关证书文件（后面统一存服务器）。
支付宝对接跟银行账号对接还不太一样，
（1）不同单位的银行账户需要做银企，下属单位通过授权的方式挂靠到集团来实现。
（2）支付宝的话就是每家单位的支付宝都是独立的，然后把每家单位的证书文件都配置到金蝶银企上就能用，目前看没有啥授权手续。
4.3相关支付宝接口学习
Alipay支付数据：
https://open.alipay.com/portal/zhichi/search?keyword=alipay.fund.account.query&pageIndex=1&pageSize=10&source=api_search&type=all
转账到支付宝账户（是一系列接口）
https://opendocs.alipay.com/open/309?pathHash=3e7dc89b
alipay.fund.account.query(支付宝资金账户资产查询接口)
alipay.fund.quota.query(转账额度查询接口)
alipay.data.bill.ereceipt.apply(申请电子回单(incubating))
alipay.data.bill.ereceipt.query(查询电子回单状态(incubating))
alipay.fund.trans.order.changed(资金单据状态变更通知)
alipay.fund.trans.uni.transfer(单笔转账接口)
alipay.fund.trans.common.query(转账业务单据查询接口)
alipay.data.dataservice.bill.downloadurl.query(查询对账单下载地址)
支持商家下载多种类型支付宝资金凭证。包括：余额收支证明、余额收支流水证明、转入转出收支证明、收支汇总证明（日汇总）以及收支汇总证明（月汇总）。
账单凭证申请分两个步骤：
1、使用alipay.data.bill.ereceipt.apply创建申请，并获取file_id信息。
2、使用file_id查询alipay.data.bill.ereceipt.query获取回单信息，回单生成完毕将会返回对应的下载链接，下载链接时效为30秒，过期将无法下载，需重新调用alipay.data.bill.ereceipt.query获取新的下载链接。
注意：接口不可单独调用，调用前需先接入对应产品，该接口相关产品如下：
转账到支付宝账户。
赞 9
打赏推荐阅读