Issue bulk reward

This API is used to issue multiple rewards to the user based on mobile number/ email Id.

While issuing bulk rewards,

  1. The intouch points required to purchase the rewards are summed up and isRedeemable call checks if the customer has enough points or not.

    1. If the customer has enough points, then all the rewards in the issue bulk call are issued in a single shot
    2. If the customer doesn't have enough points, then the issue bulk call is failed and no reward is issued.
  2. If the isRedeemable call is successful, then the system will issue the rewards to the user.

    1. Let's say, one reward is coupon, another is cart promotion in the request payload. Coupon is issued but cart promotion issual failed, this can happen and the coupon will be issued. Here in this case, partial issual will be successful.

    👍

    Note

    For detailed information about our APIs and for hands-on testing, refer documentation in API overview and step-by-step guide on making your first API call in Make your first API call .

    Prerequisites

    • Basic Authentication
    • Default access group

    Resource information

    URI/api_gateway/rewards/core/v1/user/rewards/issue?username={store}&skip_validation=true
    HTTP MethodPOST
    PaginationNo
    Batch supportNo
    Rate limit informationNone

    API endpoint example

    https://eucrm.cc.capillarytech.com/api_gateway/rewards/core/v1/user/rewards/issue?username=swati&skip_validation=true

    Request body parameters

ParameterData TypeDescription
mobile*StringMobile phone number of the customer.
Email IDStringEmail ID of the customer.
brandStringBrand associated with the transaction.
transactionNumberStringUnique identifier for the transaction.
rewardsArrayArray of rewards
associated with the transaction.
rewardIdIntegerUnique identifier for a reward.
quantityIntegerQuantity of the specified reward.

Request query parameters

ParameterData TypeDescription
Username*StringUsername name of the store.
skip_validationBooleanA validation code is used to redeem points for the transaction. skip_validation is set to true as brands configured in Marvel bypass validation code.
{
   "mobile": "919456430850",
   "brand": "BUKL",
   "transactionNumber": "transacqwert",
   "rewards": [
      
       {
           "rewardId": 13,
           "quantity": 1
       },
       {
           "rewardId": 12,
           "quantity": 1
       }
   ]
}

Response parameters

ParameterData TypeDescription
statusObjectGeneral status of the response.
successBooleanIndicates success status.
codeIntegerStatus code of the API call.
messageStringMessage describing the status.
rewardsArrayArray of rewards details.
statusObjectStatus of each individual reward.
successBooleanIndicates success status of the reward.
codeIntegerStatus code for the reward.
messageStringMessage describing the status of the reward.
rewardIdIntegerUnique identifier for the reward.
requestedQuantityIntegerQuantity of the reward requested.
pointsReferenceIdStringReference ID for points used.
intouchArrayArray of intouch details.
pointsRedeemedStringNumber of points redeemed.
couponCodeStringCoupon code provided.
codeExpiryStringExpiry date and time for the coupon code.
promotionsArrayArray of associated promotions.
vendorArrayArray of associated vendors.
{
   "status": {
       "success": true,
       "code": 200,
       "message": "Reward issued successfully"
   },
   "rewards": [
       {
           "status": {
               "success": true,
               "code": 200,
               "message": "Reward issued successfully"
           },
           "rewardId": 13,
           "requestedQuantity": 1,
           "pointsReferenceId": "VKAZF2",
           "intouch": [
               {
                   "pointsRedeemed": "50",
                   "couponCode": "JLB71ZRI",
                   "codeExpiry": "2023-06-09 00:00:00"
               }
           ],
           "promotions": [],
           "vendor": [],
           "restrictions": null
       }
   ]
}


API-specific error codes

Error codeDescription
8003Fail to issue reward
8010Reward issued partially
Language
Authorization
Basic
base64
:
URL
Click Try It! to start a request and see the response here!