Bulk Create And Allocate Rewards

Developing

POST

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

This API facilitates the creation / allocation of points to users in bulk. Request is an array of jsons (can be seen in example)

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

Header Params

Body Params application/json

Example

[
    {
"title": "Mr" , 
"name": "John hrllo",
"email": "[email protected]",
"mobile": "6836111111",
"loadAmount": 100, 
"remarks" : "good",
"uniqueReferenceNumber" :"test123457"
 }
]

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://test.your-api-server.com/api/v0/partner/enKashCard/bulk-create-allocate-points-json?companyId=CEKBVCGMR1&cardAccountId=CA1ZS96&isPointsAllocation=true' \
--header 'partnerId: CRMTTTMUF' \
--header 'Authorization: {token}' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
"title": "Mr" , 
"name": "John hrllo",
"email": "[email protected]",
"mobile": "6836111111",
"loadAmount": 100, 
"remarks" : "good",
"uniqueReferenceNumber" :"test123457"
 }
]'

Responses

🟢200Success

application/json

Body

Example

{
    "code": 0,
    "message": "Success",
    "payload": {
        "successBulkEnKashCardCreateDTOs": [
            {
                "email": "[email protected]",
                "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": "[email protected]",
                "name": "test1 testlast",
                "mobile": "6876543324",
                "title": "Mr",
                "loadAmount": 10,
                "companyId": "CEKCDVT1UV",
                "cardAccountId": "CAF0RX8N3"
            },
            {
                "email": "[email protected]",
                "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
    }
}

Modified at 2025-05-24 08:10:07

Create And Allocate Points

Get Reward Account Details