订单退费 FunctionCode | 暂无

为指定的订单执行全部或部分退费操作，支持原路退回支付账户，退款状态已以退款订单查询接口为准。

接口说明

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

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

请求参数

名称	描述	类型	必填
out_trade_no	外部订单号	String	是
trade_no	渠道交易号	String	是
refund_amount	退款金额	Price	是
payment_type	支付方式 alipay 或者 weixin 或者 unionpay 或者 eshimin 或者 elecny(数字货币)	String	否
out_request_no	标识一次退款请求	String	是
refund_reason	退款的原因说明	String	否
operator_id	商户的操作员编号	String	否
terminal_id	商户机具终端编号	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",
    "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	小程序未处于上架状态	小程序上架状态再操作