# Debit Wallet for Merchant Transaction

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v0/partner/enKashCard/ppi-merchant-transaction:
    post:
      summary: Debit Wallet for Merchant Transaction
      deprecated: false
      description: >+

        :::highlight purple 📌

        Debits the wallet balance to complete a merchant payment transaction
        securely

        :::

      tags:
        - Wallet/APIs - Wallet/Merchant Payments
      parameters:
        - name: partnerId
          in: header
          description: ''
          required: true
          example: PARTNER
          schema:
            type: string
        - name: Content-Type
          in: header
          description: ''
          required: true
          example: application/json
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                merchantDetailId:
                  type: string
                  description: Merchant Id
                enkashCardId:
                  type: string
                  description: Wallet ID
                companyId:
                  type: string
                  description: Company ID
                cardAccountId:
                  type: string
                  description: Card account id
                amount:
                  type: integer
                  description: 'amount to be transferred '
                productCode:
                  type: string
                  description: to be passed as DEFAULT
                remarks:
                  type: string
                otpMedium:
                  type: string
                  description: To be passed as MOBILE
                otp:
                  type: string
                  description: OTP
                otpReferenceId:
                  type: string
                  description: OTP reference ID
                uniqueTransactionId:
                  type: string
              required:
                - merchantDetailId
                - enkashCardId
                - companyId
                - cardAccountId
                - amount
                - productCode
                - remarks
                - otpMedium
                - otp
                - otpReferenceId
                - uniqueTransactionId
              x-apidog-orders:
                - merchantDetailId
                - enkashCardId
                - companyId
                - cardAccountId
                - amount
                - productCode
                - remarks
                - otpMedium
                - otp
                - otpReferenceId
                - uniqueTransactionId
            example:
              merchantDetailId: MD7GWIYV3VEMQ8KQ
              enkashCardId: EKCKIE9O2R
              companyId: CEKZYD5VWX
              cardAccountId: CAP1D8F
              amount: 20
              productCode: DEFAULT
              remarks: Payment towards merchant
              otpMedium: MOBILE
              otp: '123456'
              otpReferenceId: EK0N4ERDOS
              uniqueTransactionId: TXN_RANDOX123451abce
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  response_code:
                    type: integer
                  response_message:
                    type: string
                  payload:
                    type: object
                    properties:
                      status:
                        type: string
                        description: Status of transaction
                        x-apidog-mock: SUCCESS, FAILED,REFUNDED
                      enKashTransactionId:
                        type: string
                        description: Enkash Txn ID
                      uniqueTransactionId:
                        type: string
                        description: Customer Txn Id (unique)
                      txnDate:
                        type: string
                        description: Txn Date
                    required:
                      - status
                      - enKashTransactionId
                      - uniqueTransactionId
                      - txnDate
                    x-apidog-orders:
                      - status
                      - enKashTransactionId
                      - uniqueTransactionId
                      - txnDate
                required:
                  - response_code
                  - response_message
                  - payload
                x-apidog-orders:
                  - response_code
                  - response_message
                  - payload
              example:
                response_code: 0
                response_message: Success
                payload:
                  status: SUCCESS
                  enKashTransactionId: ECT2DEQ3U5RYO
                  uniqueTransactionId: TMnYYN98710091090
                  txnDate: '2025-09-01T15:01:07.872'
          headers: {}
          x-apidog-name: OK
      security: []
      x-apidog-folder: Wallet/APIs - Wallet/Merchant Payments
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/616243/apis/api-20879440-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://ekpayout-uat.enkash.in
    description: Testing Env
security: []

```