# Create And Allocate Fund To Handle

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v0/partner/enKashCard/create-allocate-points:
    post:
      summary: Create And Allocate Fund To Handle
      deprecated: false
      description: >-

        :::highlight orange 📌

        This section guides you through the sequence of actions required to
        allocate points to a user via EnKash’s reward system, ensuring data
        integrity, transaction traceability, and smooth API consumption

        :::
      tags:
        - Petty Cash/API - Petty Cash/Money Allocation
      parameters:
        - name: partnerId
          in: header
          description: ''
          required: true
          example: CRMXWB3ZM
          schema:
            type: string
        - name: Content-Type
          in: header
          description: ''
          required: true
          example: application/json
          schema:
            type: string
        - name: authorization
          in: header
          description: ''
          required: true
          example: Bearer {{access_token}}
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                companyId:
                  type: string
                  description: Unique Company Id generated on onboarding
                cardAccountId:
                  type: string
                  description: Unique Card account id for a card account being made.
                transactionCode:
                  type: object
                  properties:
                    ALLOCATION:
                      type: string
                  x-apidog-orders:
                    - ALLOCATION
                  required:
                    - ALLOCATION
                  description: ENUM
                transactionType:
                  type: object
                  properties:
                    CR:
                      type: string
                      description: Credit to enkash card
                    DR:
                      type: string
                      description: Debit from enkash card
                  x-apidog-orders:
                    - CR
                    - DR
                  required:
                    - CR
                    - DR
                  description: Card Transaction Type ENUM
                type:
                  type: object
                  properties:
                    ALLOCATE_POINT:
                      type: string
                      description: Allocate Points to card
                    UNALLOCATE_POINT:
                      type: string
                      description: UnAllocate Points from card
                  x-apidog-orders:
                    - ALLOCATE_POINT
                    - UNALLOCATE_POINT
                  description: ENUM
                  required:
                    - ALLOCATE_POINT
                    - UNALLOCATE_POINT
                email:
                  type: string
                  description: email. id of user - card holder
                mobile:
                  type: string
                  description: mobile of user -  card holder
                title:
                  type: string
                  description: Mr/Mrs/Ms
                firstName:
                  type: string
                  description: Name
                gender:
                  type: string
                  description: Male/Female
                loadAmount:
                  type: number
                  description: Amount to be loaded in card from account
                uniqueReferenceNumber:
                  type: string
                  description: Unique Transaction reference number
              required:
                - companyId
                - cardAccountId
                - transactionCode
                - transactionType
                - type
                - email
                - mobile
                - title
                - firstName
                - gender
                - loadAmount
                - uniqueReferenceNumber
              x-apidog-orders:
                - companyId
                - cardAccountId
                - transactionCode
                - transactionType
                - type
                - email
                - mobile
                - title
                - firstName
                - gender
                - loadAmount
                - uniqueReferenceNumber
            example:
              companyId: CEK1PU9AOO
              cardAccountId: CAQL8YCV3
              transactionCode: ALLOCATION
              transactionType: CR
              type: ALLOCATE_FUND
              email: xyz2@gmail.com
              mobile: '9600098867'
              title: Mr
              firstName: hedfdfg
              gender: M
              loadAmount: 11
              uniqueReferenceNum: TEST234236
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  message:
                    type: string
                  payload:
                    type: object
                    properties:
                      enKashCardId:
                        type: string
                        description: Unique Enkash Card ID
                      userId:
                        type: string
                        description: Unique Enkash User Id
                      cardAccountId:
                        type: string
                        description: Unique Enkash Card Account ID
                      email:
                        type: string
                        description: 'Email id of card holder (user) '
                      mobile:
                        type: string
                        description: Mobile number of card holder
                      title:
                        type: string
                        description: Mr, Mrs, Ms
                      firstName:
                        type: string
                        description: First Name of card holder
                      gender:
                        type: string
                        description: Gender of card holder
                      otbBalance:
                        type: integer
                        description: Available current card balance
                      cardStatus:
                        type: string
                        description: >
                          Denotes if a card is : 

                          L("Locked"), UL("UnLocked"),
                          BL("Blocked"),AP("Activation InProgress");
                      companyId:
                        type: string
                        description: 'Unique Enkash Company Id '
                    required:
                      - enKashCardId
                      - userId
                      - cardAccountId
                      - email
                      - mobile
                      - title
                      - firstName
                      - gender
                      - otbBalance
                      - cardStatus
                      - companyId
                    x-apidog-orders:
                      - enKashCardId
                      - userId
                      - cardAccountId
                      - email
                      - mobile
                      - title
                      - firstName
                      - gender
                      - otbBalance
                      - cardStatus
                      - companyId
                required:
                  - code
                  - message
                  - payload
                x-apidog-orders:
                  - code
                  - message
                  - payload
              example:
                code: 0
                message: Success
                payload:
                  enKashCardId: EKC04AZHXP
                  userId: EKIQB4L2
                  cardAccountId: CAQL8YCV3
                  token: 16b9c31b42643796e064
                  maskedNumber: XXXX XXXX XXXX 8867
                  expiryMonth: '06'
                  expiryYear: '2026'
                  email: xyz2@gmail.com
                  mobile: '9600098867'
                  title: Mr
                  firstName: hedfdfg
                  gender: M
                  usedMtd: 0
                  usedDtd: 0
                  usedYtd: 0
                  otbBalance: 11
                  primaryCard: false
                  prepaidCard: true
                  physicalCard: false
                  deleted: false
                  closedLoopCard: false
                  createdOn: Jun 20, 2024 2:56:47 PM
                  modifiedOn: Jun 20, 2024 2:56:47 PM
                  cardStatus:
                    name: UL
                    label: UnLocked
                  kycStatus:
                    name: VERIFIED
                    label: Verified
                  cardProgramme: SBM
                  useAccountFunds: false
                  blockCode: A
                  partnerLogo: https://image.enkash.in/IMAGES/sbm-logo.png
                  physicalDeliveryAddressFlag: false
                  cardActivated: true
                  binType:
                    name: REWARD
                    label: Reward Card
                  loadAmount: 11
                  companyId: CEK1PU9AOO
                  cardKitMasterId: 14
                  extEntityId: EXT3YTK2P7CYK
                  switchProvider: EK_CLOSEDLOOP_CREDIT
                  accountBalance: 38628
                  physicalCardAllowed: false
                  surchargeAmt: 0
                  panValidated: false
                  usedLtd: 0
                  latestTnCVersionAccepted: true
                  latestKeyFactAccepted: true
                  latestTnCVersionAcceptedForPrimaryCard: true
                  latestKeyFactAcceptedCardForPrimaryCard: true
                  virtualAccountNumber: ENKASHEDENKEKC04AZHXP
                  limitAllocatedLtd: 0
                  posAllowed: false
                  posAllowedAdmin: false
                  atmAllowed: false
                  atmAllowedAdmin: false
                  onlineAllowed: false
                  onlineAllowedAdmin: false
                  liveImage: false
                  cKycEnabled: false
                  unallocateFundAllowed: true
                  useParentFundAllowed: false
                  minKycOtpVerified: false
                  enKashSupportEmail: support@enkash.in
                  enKashSupportMobile: '1234567890'
                  companyName: Test Company
                  vKycAllowed: false
                  accountType:
                    name: EMPLOYEE_REWARDS
                    label: Employee Rewards
                    description: Reward
                  lastAllocatedAmount: 0
                  holdBalance: 0
                  enkashCardTxnId: ECTRSZJ8CRJ2E
                  unAllocateHoldBalance: 0
                  tncUnAllocateAllowed: false
                  tncUnAllocateAccepted: false
                  totalRewardsReceived: 1
                  rewardPointsReceived: 11
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Petty Cash/API - Petty Cash/Money Allocation
      x-apidog-status: developing
      x-run-in-apidog: https://app.apidog.com/web/project/616243/apis/api-24480516-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://ekpayout-uat.enkash.in
    description: Testing Env
security: []

```