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

# Query an acquiring payments

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

Supports querying a single payment 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

- AcquiringPaymentQueryResultVO
  - `code` integer — Return code
  - `message` string — Error message
  - `data` AcquiringPaymentQueryVO, required — Payment order object
    - `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/revisions/29c08a4da357/schema)