Bulk Create Card / Allocate Points

Developing

POST/api/v0/partner/enKashCard/bulk-create-allocate-points-json

Error messages client might expect as failure reasons in dto:-

UNPROCESSABLE_ENTITY (422): The request is semantically incorrect.
"Company Id is required if it is an Enkash User"
"Primary Enkash card is not present. So bulk upload cannot be done"
"KYC is not uploaded or under review for the primary card. So bulk upload cannot be done"
"Bin Type is not mapped on PlanMaster"
"Card Account does not exist for this partner"

NOT_FOUND (404): The requested resource was not found.
"Card account not found for companyId: [companyId] and cardAccountId: [cardAccountId]"

Request

Query Params

companyId

string

required

Enkash Company Id

Example:

CEKBVCGMR1

cardAccountId

string

required

Enkash Card account Id

Example:

CA1ZS96

isPointsAllocation

boolean

required

If the flag is true, the point will be allocated to the existing user as well as the new user.
If the flag is false only new users will be created and points will be allocated to new users , no points will be allocated to the existing users.

Example:

true

Header Params

partnerId

string

required

Example:

CRMTTTMUF

Content-Type

string

required

Example:

application/json

Authorization

string

required

Example:

{token}

array of:

title

string

optional

Mr/Mrs/Ms

name

string

optional

Name of the user

string

optional

Email id of user

mobile

string

optional

Mobile of user

loadAmount

integer

optional

Amount to be allocated to user

remarks

string

optional

(OPTIONAL)

uniqueReferenceNumber

string

optional

Unique Transaction Reference number of client

[
  {
    "title": "Mr",
    "name": "John hrllo",
    "email": "ojas.bisariya@kratikal.com",
    "mobile": "6836111111",
    "loadAmount": 100,
    "remarks": "good",
    "uniqueReferenceNumber": "test123457"
  }
]

Request samples

Responses

Success(200)

HTTP Code: 200

Content Type : JSONapplication/json

string

required

Email of the user to whom points are allocated

name

string

required

name of user

mobile

string

required

mobile number of user

title

string

required

Mr / Mrs /Ms

loadAmount

number

required

How much amount is to be loaded to user card

companyId

string

required

ENkash Company Id

cardAccountId

string

required

Enkash Card Account id

enkashCardId

string

required

Enkash Card Id of the user Card

userId

string

required

Enkash User Id

accountBalance

number

required

Balance left in account after allocation

enkashCardTxnId

string

required

Unique Transaction Id of EnKash

otbBalance

number

required

User Card Balance after allocation

successCount

number

required

number of successful allocations

failureCount

number

required

number of failed allocations

totalCount

number

required

total number of allocations

{
  "code": 0,
  "message": "Success",
  "payload": {
    "successBulkEnKashCardCreateDTOs": [
      {
        "email": "johndee@email.com",
        "name": "John Dee",
        "mobile": "6776543210",
        "title": "Mr",
        "loadAmount": 10,
        "companyId": "CEKCDVT1UV",
        "cardAccountId": "CAF0RX8N3",
        "enkashCardId": "EKCBO72AEY",
        "userId": "EKHVPYVS",
        "accountBalance": 48681,
        "enkashCardTxnId": "ECTA72T56O2SP",
        "otbBalance": 10000
      }
    ],
    "failureBulkEnKashCardCreateDTOs": [
      {
        "email": "taylor@email.com",
        "name": "test1 testlast",
        "mobile": "6876543324",
        "title": "Mr",
        "loadAmount": 10,
        "companyId": "CEKCDVT1UV",
        "cardAccountId": "CAF0RX8N3"
      },
      {
        "email": "johndee@email.com",
        "name": "John Dee",
        "mobile": "6776543210",
        "title": "Mr",
        "loadAmount": 10,
        "companyId": "CEKCDVT1UV",
        "cardAccountId": "CAF0RX8N3",
        "uniqueReferenceNumber": "123443101",
        "failureReason": "The transaction associated with the given Unique reference Number already exists"
      }
    ],
    "successCount": 1,
    "failureCount": 2,
    "totalCount": 3
  }
}

Last modified: 3 months ago