医保订单查询 FunctionCode | 暂无

该接口用于查询指定医保支付订单的自费支付状态及渠道侧的支付信息。调用方可通过商户订单号或支付单号获取订单当前状态，包括是否支付成功、支付时间、支付方式详情等。适用于业务方主动轮询订单状态或异常处理后的补偿查询场景。

接口说明

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

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

请求参数

名称	描述	类型	必填
out_trade_no	外部订单号	String	是

返回参数

名称	描述	类型	必填
sub_code	业务返回码	String	否
sub_msg	表示交易已被支付	String	否
out_trade_no	外部订单号	String	是
payment_type	支付方式 alipay 或者 weixin 或者 unionpay 或者 eshimin 或者 elecny(数字货币)	String	是
total_amount	交易的订单金额	Price	是
trade_no	支付宝交易号	String	是
logon_id	买家支付平台账号	String	否
user_id	用户的唯一userId	String	否
trade_status	交易状态	String	否
pay_date	支付时间	DateTime	是
industry_sepc_detail	行业特殊详情	Object	否

industry_sepc_detail

名称	描述	类型	必填
inner_amount	自费金额	String	是
ssc_amount	社保支付金额	String	是

接口示例

参数示例

以下是JSON：

请求参数

    {
        "out_trade_no": "2025022610253000001",
    }

返回参数

{
    "out_trade_no" : "2025022610253000001",
    "trade_no" : "I25080416155320476",
    "trade_status" : "TRADE_SUCCESS",
    "total_amount" : 25.0,
    "user_id" : "ob68ywn4FKcOKE-EfF2_fOVKG5B4",
    "logon_id" : "ob68ywn4FKcOKE-EfF2_fOVKG5B4",
    "payment_type" : "weixin",
    "pay_date" : "2025-08-04 00:02:12",
    "industry_sepc_detail" : {
        "inner_amount" : "6.00",
        "ssc_amount" : "19.00",
        "bill_no" : "ORD310100202508040001537609607",
        "response_content" : "{\"medSetlFlag\":\"SUCC\",\"setlSn\":\"SET310100202508040002110594393\",\"ownPayAmt\":6,\"directUrl\":\"https://shybggfw.smiic.net.cn:8201/hicashier/#/payResult?encData=bfb3b6f5396ffe7405ad950b343efdf90bd20f3bc4e5faf3cb63aa78b440a862130de515aabfa760db5e732f85e5f7db0412be58674ae0efac26a19135b74c689fc9d970f3556a668242eb2b4556487c31380a3949c10845210144e5b04c96f1a7e567469c67b573ffe3b4956454a9b118131da5ab75eaafeec9de2db9df5ac9ac0663bdc6555f96daf20efdd3ad58373974fb18f4392ab642afb5df634865dbbef9fcb8bcabc2ea473012a6ee08c3f7cd134389f758bdd4f6e1e7b8ca7aa6dd50476e9d4ad8e31c3bf76c96606213b859b85f199d75ffd0230eb588d84e99b9eba9f2aee5e1939ee07873e25b4625b8d07ae3da9b170c969b3a4fa5fb2eb06c78a23fa72cc7c7a4c258569202fde084\",\"deposit\":0,\"extData\":null,\"returnMsg\":\"\",\"psnAcctPay\":19,\"fundPay\":0,\"feeSumamt\":25,\"hospPartAmt\":0,\"acctMulaidPay\":0,\"selfAcctPay\":19}",
        "medical_serial_no" : "2508N204000153978835"
    },
    "sub_trade_no" : "C25080416155320476",
    "code" : "10000"
}

trade_status常见状态码

错误码	描述
WAIT_BUYER_PAY	交易创建，等待买家付款
TRADE_CLOSED	未付款交易超时关闭，或支付完成后全额退款
TRADE_SUCCESS	交易支付成功
TRADE_FINISHED	交易结束，不可退款

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	小程序未处于上架状态	小程序上架状态再操作