---
title: "Query orders by ARN"
method: GET
path: "/open-api/v3/acquiring/arn"
tags: ["Query"]
---

# Query orders by ARN

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

Supports querying the related payment order and associated refund orders by ARN.

## Query parameters

- `arn` string, required — Acquirer Reference Number

## Response `200`

OK

- AcquiringArnQueryResultVO
  - `code` integer — Return code
  - `message` string — Error message
  - `data` AcquiringArnQueryVO, required — ARN query result
    - `payment` AcquiringArnPaymentQueryVO — Associated refund orders
      - `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
      - `arn` string — Acquirer Reference Number
    - `refund` AcquiringArnPaymentQueryVO[] — Associated refund orders
      - `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
      - `arn` string — Acquirer Reference Number

## 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)