# Add Beneficiary

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v0/partner/beneficiary-detail:
    post:
      summary: Add Beneficiary
      deprecated: false
      description: >-

        :::highlight purple 📌

        Registering a beneficiary’s bank account details is a mandatory
        requirement for initiating fund transfers.

        :::
      tags:
        - Wallet/APIs - Wallet/Fund Transfers
      parameters:
        - name: partnerId
          in: header
          description: ''
          required: true
          example: CRM338L2H
          schema:
            type: string
        - name: Content-Type
          in: header
          description: ''
          required: true
          example: application/json
          schema:
            type: string
        - name: Cookie
          in: header
          description: ''
          required: false
          example: ''
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                beneficiaryName:
                  type: string
                beneficiaryAccountNumber:
                  type: string
                beneficiaryIfsc:
                  type: string
                beneficiaryEmail:
                  type: string
                beneficiaryPhone:
                  type: string
                bankName:
                  type: string
                accountType:
                  type: string
                aliasName:
                  type: string
                customerRef:
                  type: string
                cardAccountId:
                  type: string
                enKashCardId:
                  type: string
                otpMedium:
                  type: string
                otp:
                  type: string
                otpReferenceId:
                  type: string
                deviceInfo:
                  type: object
                  properties:
                    deviceId:
                      type: string
                    appVersion:
                      type: string
                    osVersion:
                      type: string
                    model:
                      type: string
                    manufracture:
                      type: string
                    platform:
                      type: string
                    simProvider:
                      type: string
                    deviceIp:
                      type: string
                    deviceImei:
                      type: string
                  x-apidog-orders:
                    - deviceId
                    - appVersion
                    - osVersion
                    - model
                    - manufracture
                    - platform
                    - simProvider
                    - deviceIp
                    - deviceImei
                  required:
                    - deviceId
                    - appVersion
                    - osVersion
                    - model
                    - manufracture
                    - platform
                    - simProvider
                    - deviceIp
                    - deviceImei
                  minProperties: 1
                  maxProperties: 10
              required:
                - beneficiaryName
                - beneficiaryAccountNumber
                - beneficiaryIfsc
                - beneficiaryEmail
                - beneficiaryPhone
                - bankName
                - accountType
                - aliasName
                - customerRef
                - cardAccountId
                - enKashCardId
                - otpMedium
                - otp
                - otpReferenceId
              x-apidog-orders:
                - beneficiaryName
                - beneficiaryAccountNumber
                - beneficiaryIfsc
                - beneficiaryEmail
                - beneficiaryPhone
                - bankName
                - accountType
                - aliasName
                - customerRef
                - cardAccountId
                - enKashCardId
                - otpMedium
                - otp
                - otpReferenceId
                - deviceInfo
            example:
              beneficiaryName: Anurag
              beneficiaryAccountNumber: '347982231219'
              beneficiaryIfsc: SBIN0000289
              beneficiaryEmail: anurag.soni@enkash.com
              beneficiaryPhone: '6000000129'
              bankName: SBI
              accountType: SAVING
              aliasName: Anurag
              customerRef: EKCWLUAADN
              cardAccountId: CAC7975
              enKashCardId: EKCWLUAADN
              otpMedium: MOBILE
              otp: '968846'
              otpReferenceId: EKR1Q285XK
              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": {
                        "enkashBeneCode": "BCN5AXVHEC",
                        "beneficiaryDetailId": "BED070746144FB",
                        "beneficiaryAccountNumber": "059801573952",
                        "beneficiaryIfsc": "ICIC0000594",
                        "beneficiaryName": "MAN",
                        "createdOn": {
                            "date": {
                                "year": 2025,
                                "month": 8,
                                "day": 26
                            },
                            "time": {
                                "hour": 17,
                                "minute": 52,
                                "second": 53,
                                "nano": 202000000
                            }
                        },
                        "modifiedOn": {
                            "date": {
                                "year": 2025,
                                "month": 8,
                                "day": 26
                            },
                            "time": {
                                "hour": 17,
                                "minute": 52,
                                "second": 53,
                                "nano": 202000000
                            }
                        },
                        "bankName": "ICICII"
                    }
                }
          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-19534222-run
components:
  schemas: {}
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
servers:
  - url: https://ekpayout-uat.enkash.in
    description: Testing Env
security: []

```