![summary-icon](https://cdn-vip.kingdee.com/statics/webfront/summary_icon.png)
本文概述了与龙岩有容雷芳老师对接某电商金蝶云星空客户时,上线支付宝银企平台的经验总结。文章包括支付宝对公账户配置、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获取新的下载链接。
注意:接口不可单独调用,调用前需先接入对应产品,该接口相关产品如下:
转账到支付宝账户。
推荐阅读