---
title: "Query an acquiring refunds"
method: GET
path: "/open-api/v3/acquiring/refunds"
tags: ["Query"]
---

# Query an acquiring refunds

`GET /open-api/v3/acquiring/refunds`

Supports querying a single refund order using either the system order number or the merchant order number.

## Query parameters

- `tradeNo` string, required — Order number
- `merchantTradeNo` string, required — Merchant-generated order number, globally unique/idempotent

## Response `200`

OK

- AcquiringRefundQueryResultVO
  - `code` integer — Return code
  - `message` string — Error message
  - `data` AcquiringRefundQueryVO, required — Refund order object
    - `tradeNo` string — Refund order number
    - `merchantTradeNo` string — Merchant refund order number
    - `amount` number — Order amount
    - `currency` string — Order currency
    - `country` string — Refund order country (required, length 2)
    - `orderStatus` 'PENDING' | 'READY' | 'PAID' | 'FAILED' | 'CANCELED' | 'REFUNDED' | 'CANCELING' | 'AUTHORIZED' | 'REFUNDING' | 'CAPTURED' | 'CLOSED' — Order status PENDING: Order Creation in Progress READY: Waiting for Customer Payment PAID: Order Paid FAILED: Order Failed CANCELED: Order Canceled by Customer REFUNDED: Order Refunded CANCELING: Order Canceling AUTHORIZED: Order Authorized REFUNDING: Order Refunding CAPTURED: Payment Captured CLOSED: Order Closed (Typically due to Expiration)
    - `orderType` 'UNDEFINED' | 'PAYMENT' | 'REFUND' — Order type
    - `createTime` string — Refund order creation time
    - `completeTime` string — Refund order completion time
    - `merchant` ApiMerchantVO — Merchant information
      - `subMerchantId` string — Sub-merchant ID (acquiring system sub-merchant ID)
    - `paymentMethod` string — Payment method enums CARD,CRYPTO_CARD

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/interlace/apis/core-resource.md) · [All operations](https://skmtc.net/interlace/apis/core-resource/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interlace/core-resource/versions/29c08a4da357/schema)