自费部分退款 FunctionCode | 暂无

该接口用于对医保支付订单中的自费部分发起退款操作。由于医保支付部分需由 HIS 系统按照国家医保流程发起退费，因此本接口仅支持退还自费金额。调用方可基于原始订单号提交退款请求，平台将处理自费金额的退款并返回退款处理结果。 适用于用户取消挂号、退药、退费等业务场景中涉及自费部分退款的处理。

接口说明

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

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

请求参数

名称	描述	类型	必填
out_trade_no	外部订单号	String	是
trade_no	渠道交易号	String	是
refund_amount	如果未指定 refund_type ，默认全额退款	Price	是
refund_type	INNERASSET=退自费部分，SSC=退社保卡部分	String	是
payment_type	支付方式 alipay 或者 weixin 或者 unionpay 或者 eshimin 或者 elecny(数字货币)	String	否
out_request_no	标识一次退款请求	String	是
refund_reason	退款的原因说明	String	否
operator_id	商户的操作员编号	String	否
terminal_id	商户机具终端编号	String	否
ssc_bill_no	人社业务号（上海地区对应 orderNo）	String	否

返回参数

名称	描述	类型	必填
sub_code	业务返回码	String	否
sub_msg	表示交易已被支付	String	否
out_trade_no	外部订单号	String	是
gmt_refund_pay	退款支付时间	String	是
refund_fee	退款总金额	Price	是

差异

此接口只发起退款申请，实际退款到账请以查询退款结果为准。

接口示例

参数示例

以下是JSON：

请求参数

    {
    "refund_reason" : "",
    "refund_amount" : "3.00",
    "ssc_bill_no" : "I25080478715323839",
    "trade_no" : "I25080478715323839",
    "refund_type" : "INNERASSET",
    "out_trade_no" : "7f2bb40300d24ec187cce25478d62521",
    "out_request_no" : "3a3bf71a8ce141d78724d5bb00984a2c",
    "operator_id" : "",
    "terminal_id" : "",
    "payment_type" : "weixin",
    "trade_amount" : "3.00"
}

返回参数

    {
    "out_trade_no" : "7f2bb40300d24ec187cce25478d62521",
    "trade_no" : "I25080478715323839",
    "refund_fee" : "3.00",
    "gmt_refund_pay" : "2025-08-04 00:26:00"
}

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