SPI-004-查询退款订单

POST

https://getway.upfreework.com/openapi/v1/refund/inquire

查询指定退款订单的详细信息和当前状态。支持查询退款的处理状态、退款金额、手续费归还、处理时间等信息。常用于确认退款结果、退款状态跟踪、财务对账等场景。

请求参数

Authorization

Header 参数

Body 参数application/json

示例

查询退款订单基本示例确认退款处理状态财务对账场景

使用退款系统订单号查询退款详情

{
    "mchId": "MCH20231120001",
    "uniqueRefundNo": "REF20231120170000001"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

查询退款订单基本示例确认退款处理状态财务对账场景

curl --location --request POST 'https://getway.upfreework.com/openapi/v1/refund/inquire' \
--header 'appId: APP123456789' \
--header 'appId;' \
--header 'appSign: a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6' \
--header 'appSign;' \
--header 'timeStamp: 1700488500000' \
--header 'timeStamp;' \
--header 'sign: b3f7a1c9e5d2a8f4c6e9b1d7f3a5c8e2' \
--header 'sign;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mchId": "MCH20231120001",
    "uniqueRefundNo": "REF20231120170000001"
}'

返回响应

🟢200成功

*/*

退款查询请求处理完成

Body

{
    "code": 0,
    "message": "查询成功",
    "context": {
        "uniqueRefundNo": "REF20231120170000001",
        "refundNo": "REFUND20231120000001",
        "orderNo": "ORDER20231120000001",
        "uniqueOrderNo": "PAY20231120154523001",
        "refundAmt": 50,
        "returnFee": 0.3,
        "status": "SUCCESS",
        "failureReason": null,
        "description": "用户申请退款",
        "memo": "部分退款",
        "refundRequestDate": "2023-11-20T17:00:00Z",
        "refundSuccessDate": "2023-11-20T17:15:30Z"
    },
    "traceId": "trace_20231120175000001",
    "spanId": "span_001"
}

修改于 2025-07-25 03:47:52

SPI-005-申请退款

FIN-001 企业钱包