当前位置：首页 > news >正文

数字药店系统源码对接医保与支付接口的开发指南

news 2026/5/12 23:53:03

做数字药店系统，很多团队都会经历同一个阶段：

商城搭好了
商品能卖了
订单能下了
配送也通了

结果一上线，用户一句话直接问懵：

“能刷医保吗？”

如果答案是不能，大量用户当场流失。

尤其是慢病、老年用户群体，医保支付几乎是刚需。

这也是为什么很多药店项目做到一半就停掉——
功能不难，真正难的是：

医保结算 + 合规支付对接。

这一步，才是数字药店从“演示系统”走向“商用系统”的分水岭。

今天就从架构和代码层面，讲清楚医保与支付接口如何落地。

一、为什么医保与支付必须单独设计？

很多人一开始的错误做法是：

在订单里直接写微信支付、支付宝支付、医保支付逻辑。

结果就是：

代码耦合严重
扩展困难
一个支付改动影响全部订单

更致命的是：

不同城市医保接口完全不同。

你不可能把逻辑写死。

正确思路只有一个：

支付能力服务化、插件化、解耦化。

推荐架构：

订单服务 order-service ↓ 支付服务 pay-service（统一入口） ↓ 微信 / 支付宝 / 医保 / 银联（策略模式扩展）

订单只关心：

创建支付单 → 调用支付服务 → 返回结果

至于具体怎么付，完全交给 pay-service。

这样未来新增医保渠道，只需新增一个实现类。

二、统一支付模型设计

先抽象一套通用支付订单。

支付表结构

CREATETABLEpay_order(idBIGINTPRIMARYKEYAUTO_INCREMENT,order_noVARCHAR(64),pay_channelVARCHAR(32),amountDECIMAL(10,2),statusVARCHAR(20),created_atDATETIME);

核心思想：

所有支付方式共用一套表。

不要为每种支付单独建表。

通用支付接口定义

publicinterfacePayStrategy{PayResultpay(PayRequestrequest);booleanrefund(StringpayNo);}

以后新增渠道，只需要实现它。

三、微信/支付宝实现示例

以微信支付为例：

@Service("wechatPay")publicclassWechatPayStrategyimplementsPayStrategy{@OverridepublicPayResultpay(PayRequestrequest){WxPayUnifiedOrderRequestwxReq=newWxPayUnifiedOrderRequest();wxReq.setBody("药品订单");wxReq.setOutTradeNo(request.getOrderNo());wxReq.setTotalFee(request.getAmount().multiply(newBigDecimal(100)).intValue());WxPayUnifiedOrderResultresult=wxService.unifiedOrder(wxReq);returnnewPayResult(result.getPrepayId());}@Overridepublicbooleanrefund(StringpayNo){returntrue;}}

四、医保支付对接核心思路

重点来了。

医保支付和普通支付完全不同。

它不是直接扣钱，而是：

用户医保账户结算 → 医保平台返回报销金额 → 用户只支付自费部分

流程会变成：

订单创建 ↓ 上传医保结算请求 ↓ 医保返回报销金额 ↓ 自费部分再走微信/支付宝

所以医保更像是：

一个结算接口，而不是纯支付接口。

五、医保接口调用示例（模拟实现）

真实医保一般是：

HTTP + 签名 + 加密 + 证书校验

示例代码：

@Service("medicalPay")publicclassMedicalPayStrategyimplementsPayStrategy{@OverridepublicPayResultpay(PayRequestrequest){Map<String,Object>params=newHashMap<>();params.put("orderNo",request.getOrderNo());params.put("totalAmount",request.getAmount());params.put("patientId",request.getUserId());Stringsign=SignUtil.sign(params,"secretKey");params.put("sign",sign);Stringresp=HttpUtil.post("https://medical-api/settle",params);MedicalRespresult=JSON.parseObject(resp,MedicalResp.class);returnnewPayResult(result.getSelfPayAmount());}@Overridepublicbooleanrefund(StringpayNo){returntrue;}}

这里返回的是：

医保报销后剩余金额。

再继续调用微信支付：

BigDecimalselfPay=medicalPay.pay(req).getAmount();wechatPay.pay(newPayRequest(orderNo,selfPay));

这样就完成：

医保 + 自费混合支付。

这才是药店真实场景。

六、订单服务如何调用支付服务？

订单侧永远不要写支付细节。

只做一件事：

调用支付中心。

@PostMapping("/pay")publicPayResultpay(@RequestBodyPayRequestrequest){returnpayFactory.get(request.getChannel()).pay(request);}

工厂模式：

@ComponentpublicclassPayFactory{@AutowiredprivateMap<String,PayStrategy>strategies;publicPayStrategyget(Stringchannel){returnstrategies.get(channel);}}