# Get Refund Transaction Status

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v0/payment/{transactionId}:
    get:
      summary: Get Refund 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 /Refund
        - order-controller
      parameters:
        - name: transactionId
          in: path
          description: ''
          required: true
          example: ''
          schema:
            type: string
        - name: Authorization
          in: header
          description: ''
          required: true
          example: ''
          schema:
            type: string
        - name: merchantAccessKey
          in: header
          description: ''
          required: true
          example: ''
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/ApplicationResponseOrderTransactionResponse
          headers: {}
          x-apidog-name: OK
      security: []
      x-apidog-folder: Payment Gateway/APIs - Payment Gateway /Refund
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/616243/apis/api-23549842-run
components:
  schemas:
    ApplicationResponseOrderTransactionResponse:
      type: object
      properties:
        response_code:
          type: integer
          format: int32
        response_message:
          type: string
        payload:
          $ref: '#/components/schemas/OrderTransactionResponse'
      x-apidog-orders:
        - response_code
        - response_message
        - payload
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    OrderTransactionResponse:
      type: object
      properties:
        transactionId:
          type: string
          description: The unique identifier for the transaction.
        created:
          type: string
          format: date-time
          description: The timestamp indicating when the transaction was created.
        lastModified:
          type: string
          format: date-time
          description: The timestamp indicating when the transaction was last modified.
        type:
          type: string
          description: The type of transaction.
          enum:
            - SALE
            - REFUND
          x-apidog-enum:
            - value: SALE
              name: ''
              description: ''
            - value: REFUND
              name: ''
              description: ''
        amount:
          type: number
          description: The amount associated with the transaction.
        currency:
          type: string
          description: The currency in which the transaction amount is specified.
        status:
          type: string
          description: The current status of the transaction.
          enum:
            - CREATED
            - PENDING_WITH_BANK
            - SUCCESS
            - FAILED
            - CANCELLED
            - CHECKOUT_RENDERED
            - REFUNDED
            - PARTIALLY_REFUNDED
            - AUTHORIZED
            - PROCESSING
            - HOLD
          x-apidog-enum:
            - value: CREATED
              name: ''
              description: ''
            - value: PENDING_WITH_BANK
              name: ''
              description: ''
            - value: SUCCESS
              name: ''
              description: ''
            - value: FAILED
              name: ''
              description: ''
            - value: CANCELLED
              name: ''
              description: ''
            - value: CHECKOUT_RENDERED
              name: ''
              description: ''
            - value: REFUNDED
              name: ''
              description: ''
            - value: PARTIALLY_REFUNDED
              name: ''
              description: ''
            - value: AUTHORIZED
              name: ''
              description: ''
            - value: PROCESSING
              name: ''
              description: ''
            - value: HOLD
              name: ''
              description: ''
        paymentDetail:
          $ref: '#/components/schemas/PaymentDetailResponse'
        bankResponse:
          $ref: '#/components/schemas/BankResponseModel'
          description: Response from the bank for the transaction.
        txnMessage:
          type: string
          description: Additional message or information related to the transaction.
        txnDate:
          type: string
          format: date-time
          description: The date when the transaction was initiated.
        surcharge:
          type: number
          description: The surcharge amount for the transaction.
        surchargeGst:
          type: number
          description: GST applied on the surcharge amount.
        finalAmount:
          type: number
          description: The final amount after considering surcharge and GST.
        txnMsg:
          type: string
          description: Additional message or information related to the transaction.
        mdr:
          type: number
          description: Merchant Discount Rate (MDR) applied on the transaction.
        mdrGst:
          type: number
          description: GST applied on the Merchant Discount Rate (MDR).
        transactionAmount:
          type: number
          description: The transaction amount.
      x-apidog-orders:
        - transactionId
        - created
        - lastModified
        - type
        - amount
        - currency
        - status
        - paymentDetail
        - bankResponse
        - txnMessage
        - txnDate
        - surcharge
        - surchargeGst
        - finalAmount
        - txnMsg
        - mdr
        - mdrGst
        - transactionAmount
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    BankResponseModel:
      type: object
      properties:
        terminalID:
          type: string
        bankTransactionId:
          type: string
      x-apidog-orders:
        - terminalID
        - bankTransactionId
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    PaymentDetailResponse:
      required:
        - paymentMode
      type: object
      properties:
        paymentMode:
          type: string
          enum:
            - NET_BANKING
            - UPI
            - CREDIT_CARD
            - DEBIT_CARD
            - PREPAID_CARD
            - PAY_LATER
            - WALLET
            - CORPORATE_CARD
            - UPI_CREDIT_CARD
          x-apidog-enum:
            - value: NET_BANKING
              name: ''
              description: ''
            - value: UPI
              name: ''
              description: ''
            - value: CREDIT_CARD
              name: ''
              description: ''
            - value: DEBIT_CARD
              name: ''
              description: ''
            - value: PREPAID_CARD
              name: ''
              description: ''
            - value: PAY_LATER
              name: ''
              description: ''
            - value: WALLET
              name: ''
              description: ''
            - value: CORPORATE_CARD
              name: ''
              description: ''
            - value: UPI_CREDIT_CARD
              name: ''
              description: ''
        cardHolderName:
          type: string
        cardNumber:
          type: string
        expiry:
          type: string
        cardType:
          type: string
          enum:
            - CREDIT_CARD
            - DEBIT_CARD
            - PREPAID_CARD
        cardSchemeType:
          type: string
          enum:
            - VISA
            - MASTERCARD
            - AMEX
            - DINERS
            - DISCOVER
            - JCB
            - MAESTRO
            - RUPAY
            - UNKNOWN
        bankCode:
          type: string
        bankName:
          type: string
        accountNumber:
          type: string
        ifsc:
          type: string
      x-apidog-orders:
        - paymentMode
        - cardHolderName
        - cardNumber
        - expiry
        - cardType
        - cardSchemeType
        - bankCode
        - bankName
        - accountNumber
        - ifsc
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes: {}
servers:
  - url: https://ekpayout-uat.enkash.in
    description: Testing Env
security: []

```