医保支付 FunctionCode | 暂无

医保接口是一套遵循国家统一标准构建的，用于实现医保业务数字化管理与交互的关键通道。其核心作用是在医保系统、医疗机构以及参保用户之间搭建起高效的信息交互桥梁，同时实现与主流支付平台（如支付宝和微信）的深度集成，全面提升医保服务的便捷性与效率。

简介

通过各渠道（支付宝，微信等）提供医保电⼦凭证激活授权，线上医保结算等服务，结合互联⽹医院线上挂号、缴费，医院⼤厅⾃助机、处⽅单⼆维码，药店线上购药等场景，患者可在⼿机端在线完成本人及亲属医保和现金部分的混合⽀付，⽅便患者就医，有效减少排队时间。

接口说明

• 请求方式 POST
• Headers serviceCode: xxx
• Headers Content-Type: application/json
• Headers Authorization: Bearer ${app_token}

正式环境	测试环境
https://api.linkingopen.com/service/openapicore/open	https://api.linkingopen.com/test/service/openapicore/open

请求参数

名称	描述	类型	必填
out_trade_no	外部订单号	String	是
ssc_scene	取值为REGISTRATION(挂号)或TREATMENT(诊间)	String	是
subject	订单标题	String	是
notify_url	通知地址	String	是
return_url	回跳页面	String	是
total_amount	交易的订单金额	Price	是
payment_type	支付方式，可选alipay、weixin、unionpay、eshimin、elecny(数字货币)	String	是
user_id	用户的唯一userId	String	是
operator_id	商户的操作员编号	String	否
timeout_express	该笔订单允许的最晚付款时间	String	否
body	订单描述	String	否
patient_name	患者真实姓名	String	是
patient_card_no	身份证号码	String	是
org_name	医疗机构名称	String	是
reduced_fee	医院减免金额（调整金额），目前微信有效	String	否
org_no	医疗机构编码	String	是
ssc_ins_type	机构类型，YB代表医保，RS代表人保	String	是
request_content	处方明细参数，各地区参数不同，微信线上诊间支付必传，支付宝支付时与ssc_serial_no二选一且优先传入ssc_serial_no ，若地区有加密要求需加密传输	String	特殊可选
city_code	城市编码	String	是
ssc_serial_no	人社系统业务流水号，由his上传处方之后返回的业务号，微信可为空，支付宝支付时与request_content二选一且优先传入ssc_serial_no	String	特殊可选
ssc_bill_no	上海地区结算时必传的orderNo	String	是
cash_fee	现金金额	String	是
insurance_fee	医保金额	String	是
credit_org	医保信用签约支付时必传的信用签约机构编码	String	是
auth_code	微信信用签约支付时必传的微信医保授权qrCode	String	是
ec_qrcode	微信信用签约支付线下时必传的医保电子凭证	String	特殊可选
ssc_eshimin_auth_code	患者随申办医保授权码，随申办必传	String	特殊可选
pay_scene	支付场景，随申办小程序支付时必传miniprogram	String	特殊可选
pay_qr_code	-	String	是
card_info	用户医保卡信息（全国医保返回），从lc.ssc.user.token返回	String	是
pay_auth_no	全国版本必传	String	是
business_params	订单扩展信息	business_params	是
is_social	国标参数，非联空调用传1返回支付参数，联空调用可不传	String	特殊可选

返回参数

名称	描述	类型	必填
sub_code	业务返回码	String	否
sub_msg	表示交易已被支付	String	否
goto_url	跳转的url	String	国标版本必返回
paystr	支付字符串（上海地区采用JSSDK方式唤起支付）	String	五期医保返回

接口示例

参数示例

以下是JSON：

请求参数

    {
        "out_trade_no": "2025022610253000001",
        "ssc_scene": "APPOINTMENT",
        "subject": "挂号付费",
        "notify_url": "https://xxxxxxxxxxxxxxx",
        "return_url": "https://xxxxxxxxxxxxxxxxxx",
        "total_amount": "25.00",
        "cash_fee": "6",
        "insurance_fee": "19",
        "reduced_fee": "",
        "user_id": "ob68ywhWuzxxxxxxxxxxxx",
        "payment_type": "weixin",
        "patient_name": "徐x",
        "patient_card_no": "31022719xxxxxxxxxxxx",
        "org_name": "上海市xxxxxxxx医院",
        "org_no": "4250xxxxxxxxx",
        "city_code": "310000",
        "ssc_ins_type": "YB",
        "request_content": "{\"medicalPayInfo\":\"{\\\"feeSumAmt\\\":\\\"25\\\",\\\"ownPayAmt\\\":\\\"6\\\",\\\"psnAcctPay\\\":\\\"19\\\",\\\"fundPay\\\":\\\"0\\\"}\"}",
        "ssc_serial_no": "",
        "ssc_bill_no": "ORD3101002025xxxxxxxxxxxxxx",
        "pay_scene": "",
        "third_open_id": "",
        "ssc_eshimin_auth_code": "42439211015537xxxxxxxxxxxxxxxxx",
        "auth_code": "",
        "credit_org": "",
        "ext_info": "{\"app_id\":\"\",\"platform\":\"h5\",\"user_container\":\"weixin\"}",
        "order_type": "APPOINTMENT",
        "card_info": "{\"payAuthNo\":\"AUTH3101002025022600xxxxxxxxxxx\",\"setlLatlnt\":\"121.xxx7,31.02xxxx\",\"kinsfolk_card_no\":\"\",\"kinsfolk_name\":\"\",\"patient_name\":\"徐x\",\"patient_card_no\":\"31022719861xxxxxxxxxxx\"}",
        "order_info": "",
        "pay_qr_code": "424392110155370780xxxxxxxx",
        "business_params": "{\"feeSumAmt\":\"25\",\"ownPayAmt\":\"6\",\"psnAcctPay\":\"19\",\"fundPay\":\"0\"}",
        "ssc_query_url": ""
    }

返回参数

    {
        "goto_url": "https://openapicore.linkingcloud.cn/SocialSecurityCard/SocialSecurityPay?appid=LCOP20190xxxxxxxxxxx&outTradeNo=2502S22xxxxxxxxxxx"
    }

SDK示例

Java

public class SDKExample {
    public static void main(String[] args) {
        // Java示例：初始化SDK并调用一个方法
        SDK sdk = new SDK();
        sdk.initialize();
        sdk.processImage("image.jpg");
    }
}

.NET

using System;

public class SDKExample {
    public static void Main() {
        // .NET 示例：初始化SDK并调用方法
        SDK sdk = new SDK();
        sdk.Initialize();
        sdk.ProcessImage("image.jpg");
    }
}

Node

async function runExample() {
    // Node.js 示例：初始化SDK并调用异步方法
    const sdk = new SDK();
    await sdk.initialize();
    await sdk.processImage('image.jpg');
}

常见业务状态码

错误码	描述	解决方案
SYSTEM_ERROR	系统繁忙	服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试
INVALID_PARAMETER	参数有误	请根据接口返回的参数非法的具体错误信息，修改参数后进行重试
APP_NOT_ONLINE	小程序未处于上架状态	小程序上架状态再操作