爱耀医药管理软件——微信支付开通及配置标准流程
(适用版本:爱耀医药管理系统V14.092及以上)
适用说明:本文档适用于药店线下POS机面对面扫码收款(顾客出示付款码,药店扫码枪扫描)场景。若用于线上小程序商城,请单独联系技术顾问获取独立配置文档。
一、注册并获取微信支付商户号
1.注册操作药店经办人访问【微信支付商户平台】(https://pay.weixin.qq.com/),按指引提交营业执照、法人身份证、对公账户等资质,审核通过后即可获得一个商户号(MCHID,10位纯数字)。
2.⚠️ 核心参数保管(必须存档,严禁外泄)注册过程中,系统会生成或要求设置以下关键信息,请使用专用密码本或企业保险柜记录,严禁截图发群、粘贴至公开网页或告知无关人员:
o账户身份类:商户号(10位数字)、绑定管理员收银微信号、管理员手机号、商户平台登录密码。
oAPI交互类(系统对接必需):
§APIv2密钥:在商户平台【账户中心→API安全】中设置,必须为32位,且须包含大写字母+小写字母+数字(建议使用系统随机生成,勿用简单密码)。
§APIv3密钥:同上位置设置,同为32位组合(与v2密钥不同,切勿设为相同)。
§API证书序列号:下载证书后,在证书详情中可查看该40位字符序列号。
§微信支付公钥ID:在【账户中心→公钥】页面获取。
3.开通支付产品在商户平台【产品中心】中,根据爱耀POS端需求,开通“付款码支付”(即被扫支付)和“Native支付”两项基础产品。
二、将商户号与药店应用绑定(以“企业微信”为例)
由于每个药店的线上载体不同(如公众号、小程序、企业微信等),本文以最常用的“企业微信——企业支付”功能为例,其他应用绑定逻辑类似。
1.注册企业微信并完成验证访问【企业微信官网】(https://work.weixin.qq.com/),注册企业账号,并提交药店资质完成主体认证。
2.准备绑定所需资料(此步为风控审核,缺一不可)在企业微信后台申请“企业支付”功能时,需再次上传以下影像资料(请提前存于电脑桌面):
o营业执照、药品经营许可证、食品/保健品备案凭证、二类医疗器械备案凭证;
o法人身份证正反面照片;
o药店室外门头照(含招牌)、室内经营场景照各一张。
3.获取企业微信侧的应用参数审核通过后,在企业微信后台【应用管理】中可查看到以下信息,请与第一步的商户号分开记录(切勿混淆):
o企业微信AppID(通常以wx开头,18位字母数字组合);
oAgentId(企业微信内部分配的应用编号);
o企业支付收款密钥(仅用于企业微信内部结算)。
三、完成商户号与企业微信的授权关联(关键审核环节)
1.发起授权申请药店管理员打开手机微信,搜索并进入“微信支付商家助手”小程序,选择【关联AppID】,输入第二步中获取的企业微信AppID,提交关联申请。
2.双方确认授权微信支付平台将在1~3个工作日内完成审核。审核通过后:
o微信支付商家助手会发送审核通过通知;
o管理员需再次登录企业微信管理后台 → 【应用管理】 → 【企业支付】,在待办事项中点击“确认授权”。至此,双方绑定正式生效。
四、爱耀管理系统后台参数配置(核心步骤,请仔细对照)
配置前请确认:爱耀管理系统的服务器出口IP,已添加到微信支付商户平台的【支付回调白名单】中,否则将无法正常通讯。
1.登录爱耀管理系统,依次进入:【系统设置】 → 【支付接口设置】 → 【微信支付设置】。
2.输入管理员密码进行授权,进入参数编辑界面。
3.严格按照下表对应关系录入(严禁错位填写):
爱耀系统内显示字段 | 应填写内容(来源) | 特别提醒 |
应用AppID | 填写第二步中获取的企业微信AppID(以wx开头) | 此处非公众号AppID,也非商户号 |
商户号(MCHID) | 填写第一步中微信支付平台分配的10位纯数字商户号 | 此处非企业微信的AgentId |
支付私钥 / API密钥 | 填写第一步中在商户平台设置的APIv2密钥(32位) | 此处非企业微信的收款密钥,请勿填错 |
APIv3密钥 | 填写第一步中设置的APIv3密钥(32位) | 用于处理退款及回调通知加密 |
证书序列号 | 填写第一步下载的API证书序列号 | 需与上传的爱耀服务器证书完全匹配 |
4.录入完毕后,依次点击【保存参数】 → 【保存】 → 【退出】。(注意:无需重启爱耀主程序,仅在POS收银界面点击“刷新配置”即可生效。)
五、支付功能验证(必须实测通过方可投入使用)
1.进入爱耀POS收银界面,录入一个极小金额商品(建议0.01元的医用棉签或创可贴)。
2.结算时选择支付方式为“微信支付”。
3.药店收银员使用扫码枪,对准顾客手机上的微信付款码(条形码/二维码)进行扫描。
o⚠️ 严禁扫描顾客的付款码截图,必须当面动态扫码,以防资金风险。
4.系统播报“微信支付收款到账X元”语音提示,且POS小票打印成功,即代表配置全部正确。
至此,爱耀医药管理系统微信支付全流程开通并验证完毕,药店可正常开展微信收款业务。🎉完美收工!
附:常见问题速查(避坑指南)
报错现象 | 可能原因 | 解决办法 |
提示“商户号不存在” | 第四步商户号填成了企业微信AgentId | 改为填写微信支付平台的10位纯数字商户号 |
提示“签名错误(SIGNERROR)” | APIv2密钥填错或大小写不一致 | 登录商户平台重置APIv2密钥,重新复制粘贴 |
提示“证书序列号不匹配” | 爱耀服务器未上传正确格式的pem证书 | 联系爱耀技术客服,重新上传商户证书文件 |
扫码后提示“付款码无效” | 扫码枪误扫了微信“收款码”(用于他人扫你) | 确认扫描的是顾客手机上的“付款码”(条形码形态) |
适用版本:爱耀医药管理系统V14.092及以上如果您的药店实际使用的是线上小程序/H5商城支付场景,或需要配置分账/营销退款等高级功能,请告知,爱耀团队可为您单独撰写补充章节。希望对您有帮助!
夜雨聆风