# Get Transaction Status

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v0/payment/{transactionId}:
    get:
      summary: Get Transaction Status
      deprecated: false
      description: >-

        :::highlight purple 📌

        Use this API to retrieve the current status of a transaction using a
        unique transaction identifier. This allows you to verify whether a
        payment was successful, pending, or failed, and helps keep your records
        and user notifications up to date.

        :::
      operationId: merchantEnquiry
      tags:
        - Payment Gateway/APIs - Payment Gateway /Payment
        - order-controller
      parameters:
        - name: transactionId
          in: path
          description: Transaction Id
          required: true
          example: EK1743074262175e8KIO
          schema:
            type: string
        - name: Authorization
          in: header
          description: Token generated with your Access key and secret key
          required: true
          example: Bearer FgRkY5765702145869544866OAXTT
          schema:
            type: string
        - name: merchantAccessKey
          in: header
          description: The access key generated for your account
          required: true
          example: ZJjAg195FnUlR1535
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  response_code:
                    type: integer
                    description: Application-level status code. 0 indicates success.
                    examples:
                      - 0
                  response_message:
                    type: string
                    description: High-level status description.
                    examples:
                      - Success
                  payload:
                    type: object
                    description: Transaction details.
                    properties:
                      transactionId:
                        type: string
                        description: The unique identifier for the transaction.
                        examples:
                          - EK1775041139422MCvJu
                      created:
                        type: string
                        description: >-
                          Transaction creation timestamp. Format: yyyy-MM-dd
                          HH:mm:ss (IST).
                        examples:
                          - '2026-04-01 16:28:59'
                      lastModified:
                        type: string
                        description: >-
                          Last modification timestamp. Format: yyyy-MM-dd
                          HH:mm:ss (IST).
                        examples:
                          - '2026-04-01 16:29:40'
                      merchantOrderId:
                        type: string
                        description: Merchant's unique order reference ID.
                        examples:
                          - EK38129MYTT
                      type:
                        type: string
                        description: Transaction type.
                        enum:
                          - SALE
                          - REFUND
                        examples:
                          - SALE
                      amount:
                        type: number
                        description: Original transaction amount.
                        examples:
                          - 1
                      currency:
                        type: string
                        description: Currency of the transaction.
                        examples:
                          - INR
                      status:
                        type: string
                        description: Current transaction status.
                        enum:
                          - CREATED
                          - AUTHORIZED
                          - PENDING_WITH_BANK
                          - SUCCESS
                          - FAILED
                          - CANCELLED
                          - PARTIALLY_REFUNDED
                          - REFUNDED
                        examples:
                          - SUCCESS
                      paymentDetail:
                        type: object
                        description: Payment mode specific details.
                        properties:
                          paymentMode:
                            type: string
                            description: Payment mode used for the transaction.
                            examples:
                              - CREDIT_CARD
                          cardHolderName:
                            type: string
                            description: Name printed on the card.
                            examples:
                              - Raghav Gupta
                          cardNumber:
                            type: string
                            description: Masked card number.
                            examples:
                              - XXXX XXXX XXXX 2000
                          expiry:
                            type: string
                            description: Card expiry date.
                            examples:
                              - 05/2030
                          cardType:
                            type: string
                            description: Type of card used.
                            examples:
                              - CREDIT_CARD
                          cardSchemeType:
                            type: string
                            description: Card scheme type.
                            examples:
                              - VISA
                          bankName:
                            type: string
                            description: Issuing bank name.
                            examples:
                              - ICICI BANK LTD
                          paymentToken:
                            type: string
                            description: Payment token associated with the transaction.
                            examples:
                              - 8fcda4ce927ca0b011
                          enkashPgCode:
                            type: string
                            description: Internal EnKash payment gateway code.
                            examples:
                              - CPPA005
                        x-apidog-orders:
                          - paymentMode
                          - cardHolderName
                          - cardNumber
                          - expiry
                          - cardType
                          - cardSchemeType
                          - bankName
                          - paymentToken
                          - enkashPgCode
                      bankResponse:
                        type: object
                        description: Response received from the bank.
                        properties:
                          terminalID:
                            type: string
                            description: Bank terminal identifier.
                            examples:
                              - '114828'
                          bankTransactionId:
                            type: string
                            description: Bank transaction reference number.
                            examples:
                              - '609116830777'
                        x-apidog-orders:
                          - terminalID
                          - bankTransactionId
                      txnMessage:
                        type: string
                        description: Additional message related to the transaction.
                        examples:
                          - Transaction Successful
                      txnDate:
                        type: string
                        description: >-
                          Transaction timestamp. Format: yyyy-MM-dd HH:mm:ss
                          (IST).
                        examples:
                          - '2026-04-01 16:29:39'
                      surcharge:
                        type: number
                        description: >-
                          Convenience fee or surcharge applied to the
                          transaction.
                        examples:
                          - 0.02
                      surchargeGst:
                        type: number
                        description: GST applied on the surcharge amount.
                        examples:
                          - 0.0036
                      productCode:
                        type: string
                        description: Product category associated with the transaction.
                        examples:
                          - QUICK_COLLECT_COLLECTION
                    required:
                      - transactionId
                      - created
                      - type
                      - amount
                      - currency
                      - status
                    x-apidog-orders:
                      - transactionId
                      - created
                      - lastModified
                      - merchantOrderId
                      - type
                      - amount
                      - currency
                      - status
                      - paymentDetail
                      - bankResponse
                      - txnMessage
                      - txnDate
                      - surcharge
                      - surchargeGst
                      - productCode
                required:
                  - response_code
                  - response_message
                  - payload
                x-apidog-orders:
                  - response_code
                  - response_message
                  - payload
                examples:
                  - response_code: 0
                    response_message: Success
                    payload:
                      transactionId: EK1775041139422MCvJu
                      created: '2026-04-01 16:28:59'
                      lastModified: '2026-04-01 16:29:40'
                      type: SALE
                      amount: 1
                      currency: INR
                      status: SUCCESS
                      paymentDetail:
                        paymentMode: CREDIT_CARD
                        cardHolderName: Raghav Gupta
                        cardNumber: XXXX XXXX XXXX 2000
                        expiry: 05/2030
                        cardType: CREDIT_CARD
                        cardSchemeType: VISA
                        bankName: ICICI BANK LTD
                        paymentToken: 8fcda4ce927ca0b011
                        enkashPgCode: CPPA005
                      bankResponse:
                        terminalID: '114828'
                        bankTransactionId: '609116830777'
                      txnMessage: Transaction Successful
                      txnDate: '2026-04-01 16:29:39'
                      surcharge: 0.02
                      surchargeGst: 0.0036
                      productCode: QUICK_COLLECT_COLLECTION
                      merchantOrderId: EK38129MYTT
              example:
                response_code: 0
                response_message: Success
                payload:
                  transactionId: EK1775041139422MCvJu
                  created: '2026-04-01 16:28:59'
                  lastModified: '2026-04-01 16:29:40'
                  type: SALE
                  amount: 1
                  currency: INR
                  status: SUCCESS
                  paymentDetail:
                    paymentMode: CREDIT_CARD
                    cardHolderName: Raghav Gupta
                    cardNumber: XXXX XXXX XXXX 2000
                    expiry: 05/2030
                    cardType: CREDIT_CARD
                    cardSchemeType: VISA
                    bankName: ICICI BANK LTD
                    paymentToken: 8fcda4ce927ca0b011
                    enkashPgCode: CPPA005
                  bankResponse:
                    terminalID: '114828'
                    bankTransactionId: '609116830777'
                  txnMessage: Transaction Successful
                  txnDate: '2026-04-01 16:29:39'
                  surcharge: 0.02
                  surchargeGst: 0.0036
                  productCode: QUICK_COLLECT_COLLECTION
                  merchantOrderId: EK38129MYTT
          headers: {}
          x-apidog-name: OK
      security: []
      x-apidog-folder: Payment Gateway/APIs - Payment Gateway /Payment
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/616243/apis/api-8990252-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://ekpayout-uat.enkash.in
    description: Testing Env
security: []

```
