# Refund Webhook Request

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /merchant_url:
    post:
      summary: Refund Webhook Request
      deprecated: false
      description: >+

        :::highlight purple 📌

        Use this API to receive payment status notifications from Enkash. You
        must develop this API on your backend to handle incoming payment updates
        (such as success or failure). Provide the endpoint URL in the Create
        Order API so Enkash can notify your system when the payment status
        changes.

        :::

      tags:
        - Payment Gateway/APIs - Payment Gateway /Refund
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                amount:
                  type: number
                paymentMode:
                  type: string
                  enum:
                    - CREDIT_CARD
                    - DEBIT_CARD
                    - PREPAID_CARD
                    - CORPORATE_CARD
                    - NET_BANKING
                    - UPI
                    - UPI_CREDIT_CARD
                    - PAY_LATER
                    - WALLET
                  x-apidog-enum:
                    - value: CREDIT_CARD
                      name: ''
                      description: ''
                    - value: DEBIT_CARD
                      name: ''
                      description: ''
                    - value: PREPAID_CARD
                      name: ''
                      description: ''
                    - value: CORPORATE_CARD
                      name: ''
                      description: ''
                    - value: NET_BANKING
                      name: ''
                      description: ''
                    - value: UPI
                      name: ''
                      description: ''
                    - value: UPI_CREDIT_CARD
                      name: ''
                      description: ''
                    - value: PAY_LATER
                      name: ''
                      description: ''
                    - value: WALLET
                      name: ''
                      description: ''
                bankCode:
                  type: string
                bankName:
                  type: string
                cardScheme:
                  type: string
                currency:
                  type: string
                checksum:
                  type: string
                status:
                  type: string
                transactionId:
                  type: string
                txnMsg:
                  type: string
                txnDate:
                  type: string
                  format: date-time
                uniqueTransactionId:
                  type: string
                maskedCardNumber:
                  type: string
                cardHolderName:
                  type: string
                paymentToken:
                  type: string
                bankTransactionId:
                  type: string
                orderId:
                  type: string
              required:
                - amount
                - bankCode
                - bankName
                - cardScheme
                - currency
                - checksum
                - status
                - transactionId
                - txnMsg
                - txnDate
                - uniqueTransactionId
                - maskedCardNumber
                - cardHolderName
                - paymentToken
                - bankTransactionId
                - orderId
                - paymentMode
              x-apidog-orders:
                - amount
                - paymentMode
                - bankCode
                - bankName
                - cardScheme
                - currency
                - checksum
                - status
                - transactionId
                - txnMsg
                - txnDate
                - uniqueTransactionId
                - maskedCardNumber
                - cardHolderName
                - paymentToken
                - bankTransactionId
                - orderId
            example:
              surcharge: 0
              surchargeGst: 0
              amount: '500.00'
              finalAmount: '500.00'
              paymentMode: PREPAID_CARD
              bankCode: null
              bankName: null
              cardScheme: null
              currency: INR
              checksum: null
              status: SUCCESS
              transactionId: EK1738916997652yh8GL
              txnMsg: Transaction successful.
              txnDate: '2025-02-07 14:00:05'
              uniqueTransactionId: EK66674UU7T
              maskedCardNumber: XXXX XXXX XXXX 9015
              cardHolderName: NA
              paymentToken: 9ceac38e65db443d5f48
              bankTransactionId: null
              mdr: null
              mdrGst: null
              transactionAmount: null
              orderId: null
              orderStatus: null
              transactionStatus: null
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
                x-apidog-refs: {}
                x-apidog-orders: []
          headers: {}
          x-apidog-name: Success
      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-23550015-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://ekpayout-uat.enkash.in
    description: Testing Env
security: []

```