# IMPS Fund Transfer

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v0/partner/instant-payout:
    post:
      summary: IMPS Fund Transfer
      deprecated: false
      description: >-

        :::highlight purple 📌

        Initiate instant fund transfers to a registered beneficiary’s bank
        account using the IMPS network, with real-time processing and
        confirmation.

        :::
      tags:
        - Wallet/APIs - Wallet/Fund Transfers
      parameters:
        - name: Content-Type
          in: header
          description: ''
          required: true
          example: application/json
          schema:
            type: string
        - name: partnerId
          in: header
          description: ''
          required: true
          example: CRM338L2H
          schema:
            type: string
        - name: authorization
          in: header
          description: ''
          required: true
          example: Bearer hxtaSWH8zb5XrA71XDrgFu1uO50
          schema:
            type: string
        - name: Cookie
          in: header
          description: ''
          required: true
          example: >-
            _cfuvid=jS8C5lxGW4Q6FRWotUQnMGhbxbpGmvk3fGg1kdmq4WM-1752680737979-0.0.1.1-604800000;
            JSESSIONID=6709E31F4515A4151FABAC8E52CAD2A0
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                enkashCardId:
                  type: string
                  description: Source Wallet Id
                amount:
                  type: integer
                  description: Amount
                productCode:
                  type: string
                  description: PAYOUT_TRANSFER
                merchantName:
                  type: string
                  description: payee name
                remarks:
                  type: string
                  description: remarks
                payoutMode:
                  type: string
                  description: IMPS
                otpMedium:
                  type: string
                  description: MOBILE
                otp:
                  type: string
                  description: Otp Received on wallet holder number
                otpReferenceId:
                  type: string
                  description: |
                    OTP reference Id which can be get from "Generate OTP" API
                beneficiaryDetailId:
                  type: string
                  description: Beneficiary Detail Id (linked to each beneficiary)
                cardAccountId:
                  type: string
                  description: Card Account Id
                uniqueTxnReferenceId:
                  type: string
                  description: |
                    Unique Transaction Reference ID
                deviceInfo:
                  type: object
                  properties:
                    deviceId:
                      type: string
                      description: Unique identifier.
                    appVersion:
                      type: string
                      description: >-
                        Version of the mobile application installed on the
                        device.
                    osVersion:
                      type: string
                      description: Operating system version running on the device.
                    model:
                      type: string
                      description: Device model name as provided by the operating system.
                    manufracture:
                      type: string
                      description: Device manufacturer name.
                    platform:
                      type: string
                      description: Device platform type (e.g., android, ios).
                    simProvider:
                      type: string
                      description: Mobile network operator of the device SIM.
                    deviceIp:
                      type: string
                      description: IP address of the device at the time of request.
                    deviceImei:
                      type: string
                      description: >-
                        International Mobile Equipment Identity (IMEI) of the
                        device.
                  x-apidog-orders:
                    - deviceId
                    - appVersion
                    - osVersion
                    - model
                    - manufracture
                    - platform
                    - simProvider
                    - deviceIp
                    - deviceImei
                  required:
                    - deviceId
                    - appVersion
                    - osVersion
                    - model
                    - manufracture
                    - platform
                    - simProvider
                    - deviceIp
                    - deviceImei
              required:
                - enkashCardId
                - amount
                - productCode
                - merchantName
                - remarks
                - payoutMode
                - otpMedium
                - otp
                - otpReferenceId
                - beneficiaryDetailId
                - cardAccountId
                - uniqueTxnReferenceId
                - deviceInfo
              x-apidog-orders:
                - enkashCardId
                - amount
                - productCode
                - merchantName
                - remarks
                - payoutMode
                - otpMedium
                - otp
                - otpReferenceId
                - beneficiaryDetailId
                - cardAccountId
                - uniqueTxnReferenceId
                - deviceInfo
            example:
              beneficiaryDetailId: BED22433536Z5F
              enkashCardId: EKCBEFFEC1
              amount: 10
              productCode: DEFAULT
              merchantName: enkash
              remarks: test
              payoutMode: IMPS
              otpMedium: MOBILE
              otp: '968846'
              otpReferenceId: EKR1Q285XK
              cardAccountId: CAC7975
              uniqueTxnReferenceId: ABC1234
              deviceInfo:
                deviceId: DEVICE_ABC123456
                appVersion: 2.1.0
                osVersion: Android 14
                model: Samsung S23
                manufracture: Samsung
                platform: ANDROID
                simProvider: Airtel
                deviceIp: 192.168.1.10
                deviceImei: '356789123456789'
      responses:
        '200':
          description: ''
          content:
            '*/*':
              schema:
                type: object
                properties: {}
              example: |-
                {
                    "code": 0,
                    "message": "Success",
                    "payload": {
                        "status": "SUCCESS",
                        "amount": 10,
                        "enKashTransactionId": "ECT0Z606F796N",
                        "instantPayoutId": "PT85790603SJ3F",
                        "paymentDate": {
                            "date": {
                                "year": 2025,
                                "month": 8,
                                "day": 20
                            },
                            "time": {
                                "hour": 23,
                                "minute": 52,
                                "second": 9,
                                "nano": 430000000
                            }
                        },
                        "createdOn": {
                            "date": {
                                "year": 2025,
                                "month": 8,
                                "day": 20
                            },
                            "time": {
                                "hour": 23,
                                "minute": 52,
                                "second": 9,
                                "nano": 257000000
                            }
                        }
                    }
                }
          headers: {}
          x-apidog-name: OK
      security:
        - bearer: []
      x-apidog-folder: Wallet/APIs - Wallet/Fund Transfers
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/616243/apis/api-19531699-run
components:
  schemas: {}
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
servers:
  - url: https://ekpayout-uat.enkash.in
    description: Testing Env
security: []

```