#使用技巧#【熊说银企SOP】支付宝：银企投产指南（支付宝推广版）

关键词：银企直联、支付宝、公网、投产正式环境、第三方支付

参考文档：

支付宝对公企业客服电话：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签约功能说明

1. 转账到支付宝账户（余额查询、转账到支付宝账号）

2. 如果客户还需要签约对账单查询，需要签约当面付 手机网站支付 电脑网站支付 APP支付四大支付产品中任意一个，需要注意会涉及费率，不过如果只用对账单应该没问题，需要客户和支付宝确认。

1.5总结

建议特别是对接N家公司支付宝账户时，建议整理一个Excel表，列头如下所示：

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获取新的下载链接。

注意：接口不可单独调用，调用前需先接入对应产品，该接口相关产品如下：

转账到支付宝账户。