---
title: "Search for acquired payments and refunds"
method: POST
path: "/open-api/v3/acquiring/search"
tags: ["Query"]
---

# Search for acquired payments and refunds

`POST /open-api/v3/acquiring/search`

Supports querying multiple payment or refund orders using either the system order number or the merchant order number. Settlement information is not currently available for these orders, and no fee or charge details are provided. A reconciliation (settlement) API will be introduced later as needed.

## Request body

- AcquiringSearchReqDTO
  - `page` integer — Current page
  - `limit` integer — Limit
  - `tradeNo` string — Order number
  - `merchantTradeNo` string — Merchant-generated order number, globally unique/idempotent
  - `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
  - `subMerchantId` string — Sub-merchant ID (acquiring system sub-merchant ID)
  - `paymentMethod` string — Payment method Type

## Response `200`

OK

- AcquiringSearchResultVO
  - `code` integer — Return code
  - `message` string — Error message
  - `data` PageAcquiringSearchVO, required — Order pagination query results
    - `total` integer — Total
    - `limit` integer — Limit
    - `page` integer — Current page
    - `records` AcquiringSearchVO[] — Records
      - `tradeNo` string — Order number
      - `merchantTradeNo` string — Merchant order number
      - `amount` number — Order amount
      - `currency` string — Order currency
      - `country` string — Order country
      - `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 — Order creation time
      - `completeTime` string — Order completion time
      - `merchant` ApiMerchantVO — Merchant information
        - `subMerchantId` string — Sub-merchant ID (acquiring system sub-merchant ID)
      - `card` PaymentCardVO — Card information
        - `firstName` string — First name
        - `lastName` string — Last name
        - `pan` string — Card number
      - `customer` PaymentCustomerVO — Customer information
        - `merchantCustomerId` string — Customer ID
        - `firstName` string — First name
        - `lastName` string — Last name
        - `phoneNumber` string — Phone number
        - `email` string — Email
      - `billAddress` PaymentBillAddressVO — Bill Address information
        - `addressLine1` string — Address line 1
        - `addressLine2` string — Address line 2
        - `city` string — City
        - `state` string — State
        - `country` string — Country abbreviation
        - `postalCode` string — Postal code
      - `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)