退款订单查询 FunctionCode | 暂无

该接口用于查询指定订单的退款状态及，适用于业务方主动轮询订单状态或异常处理后的补偿查询场景。

接口说明

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

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

请求参数

名称	描述	类型	必填
out_trade_no	外部订单号	String	是
out_request_no	标识一次退款请求	String	是
trade_no	渠道订单号	String	否

返回参数

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

接口示例

参数示例

以下是JSON：

请求参数

    {
        "out_trade_no": "YB00MZGH1401701591769804800",
        "out_request_no":"T1401701629409226752"
    }

返回参数

{
    "out_trade_no" : "YB00MZGH1401701591769804800",
    "trade_no" : "2025080422001478701417997359",
    "out_request_no" : "T1401701629409226752",
    "refund_amount" : 25.0,
    "refund_status" : "REFUND_SUCCESS"
}

refund_status常见状态码

错误码	描述
WAIT_BUYER_PAY	交易创建，等待买家付款
TRADE_CLOSED	未付款交易超时关闭，或支付完成后全额退款
REFUND_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	小程序未处于上架状态	小程序上架状态再操作