---
title: "Transaction Status"
method: POST
path: "/txnStatus"
---

# Transaction Status

`POST /txnStatus`

Check the status of any transaction initiated on InstantPay platform. Call this API after 15 minutes of transaction completion and if transaction is in PENDING (TUP) or TIMEOUT (no response) status. Maintain a time difference of at least 4 hours between status query attempts for the same transaction.

## Headers

- `X-Ipay-Auth-Code` string
- `X-Ipay-Client-Id` string
- `X-Ipay-Client-Secret` string
- `X-Ipay-Endpoint-Ip` string

## Request body

- object
  - `transactionDate` string, date
  - `externalRef` string
  - `source` string

## Response `200`

200

- object
  - `statuscode` string
  - `actcode` unknown
  - `status` string
  - `data` object
    - `transactionDateTime` string
    - `transactionStatusCode` string
    - `transactionStatus` string
    - `transactionAmount` string
    - `transactionReferenceId` string
    - `order` object
      - `referenceId` string
      - `externalRef` string
      - `spKey` string
      - `spName` string
      - `sspKey` string
      - `sspName` unknown
      - `account` string
      - `optional1Label` string
      - `optional1` string
      - `optional2Label` string
      - `optional2` string
      - `optional3Label` string
      - `optional3` string
      - `optional4Label` string
      - `optional4` string
      - `optional5Label` string
      - `optional5` string
      - `optional6Label` string
      - `optional6` string
      - `optional7Label` string
      - `optional7` string
      - `optional8Label` string
      - `optional8` string
      - `optional9Label` string
      - `optional9` string
    - `pool` object
      - `transaction` object
        - `referenceId` string
        - `openingBalance` string
        - `paymentAmount` string
        - `mode` string
        - `closingBalance` string
        - `convenienceFee` string
        - `surcharge` string
        - `cashback` string
        - `tds` string
      - `reversal` object
        - `referenceId` unknown
        - `openingBalance` unknown
        - `paymentAmount` unknown
        - `mode` unknown
        - `closingBalance` unknown
    - `tag` object
      - `1` object
        - `desc` unknown
        - `value` unknown
      - `2` object
        - `desc` unknown
        - `value` unknown
      - `3` object
        - `desc` unknown
        - `value` unknown
      - `4` object
        - `desc` unknown
        - `value` unknown
      - `5` object
        - `desc` unknown
        - `value` unknown
  - `timestamp` string
  - `ipay_uuid` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/instantpay/apis/identity.md) · [All operations](https://skmtc.net/instantpay/apis/identity/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instantpay/identity/revisions/1d0672797b14/schema)