# Get ARN codes

Get ARN codes request obtains ARN codes for specific orders, providing essential information about refunds, currencies, and transaction statuses.

Endpoint: POST /arn-code
Version: 1.0.0
Security: merchant, signature

## Header parameters:

  - `merchant` (string, required)

  - `signature` (string, required)

## Request fields (application/json):

  - `order_id` (string, required)
    Unique order identifier, which can be used to find the payment.
For the first payment, the identifier is defined by the merchant.For recurring subscription-based payments, it is generated by the Solidgate subscription service.
    Example: 923bb4e6-4a5f-41ec-81fb-28eb8a152e55

## Response 200 fields (application/json):

  - `arn_codes` (array)
    Array data with information about ARN codes corresponding to the order requested.

  - `arn_codes.arn_code` (string, required)
    Acquirer Reference Number (ARN) assigned to transactions.
Use ARN to check transaction status.
    Example: 12345678901234567890123

  - `arn_codes.created_at` (string, required)
    Datetime when the refund was created.
    Example: 2026-07-15 11:45:30

  - `arn_codes.amount_refunded` (integer, required)
    Refund amount.
    Example: 100

  - `arn_codes.currency` (string, required)
    Three-letter ISO-4217 currency code.
    Example: USD

  - `arn_codes.transaction_status` (string, required)
    Status of the transaction.
    Enum: "processing", "success", "fail", "verify"

  - `arn_codes.sp_transaction_id` (string)
    Unique transaction identifier.
    Example: 9ec44dfd75936f248a5d68dd7045bbbd63ab10ad9246f

  - `error` (object, required)
    Error object.

  - `error.code` (string, required)
    Unauthorized access due to invalid credentials.
    Example: 1.01

  - `error.messages` (array, required)
    Array of error messages applied to the decline payment.