API Error Cases

Understand the custom error responses you may encounter when making requests to the Wallet and Coupon APIs.

Wallet API Errors

The following are the custom API errors that you may receive upon failure requests of the Wallet APIs:

Error CodeError CaseError DetailsApplicable API
777Invalid or incorrect wallet_IdThe specified Wallet ID is invalid or does not exist.All Wallet APIs
400Missing required path parameterThe PARAMETER_NAME is a mandatory key.All Wallet APIs
777Invalid transactionTypeThis error occurs when the transactionType key is invalid. It must be either DEBIT or CREDIT.Debit/Credit Wallet API
777Missing mandatory key in the payloadKEY_NAME is required.Debit/Credit Wallet API
500Incorrect data type for pointsThe points field must be numeric.Debit/Credit Wallet API
777Negative points passed in the requestpoints must always be a positive value.Debit/Credit Wallet API
777Debit points exceed the active points in the user's walletThe points to be debited cannot exceed the available balance in the user's wallet.Debit/Credit Wallet API
777Metadata is provided, but is an empty object ({})The metadata key value can not be emptyDebit/Credit Wallet API

Coupon API Errors

The following are the custom API errors that you may receive upon failed requests of the Coupon APIs:

Error CodesError CaseError DetailsApplicable API
777Wrong field added in request body or mandatory fields not passedA required field KEY_NAME is missing in the request body.All APIs
777Coupon is expiredThe coupon code has expired and is no longer valid.All APIs
777Total coupon redemption limit exceededThe total redemption limit for the coupon has been exceeded.All APIs
777Per-user redemption limit exceededThe per-user redemption limit for the coupon has been exceeded.All APIs
777Daily/Weekly/Monthly redemption exceededThe coupon's daily, weekly, or monthly redemption limit has been exceeded.All APIs
777Coupon not available for specific days or timesThe coupon is not valid during the current day or time.All APIs
777Coupon cart validation failedThe coupon cart validation failed based on specified conditions.All APIs
777Coupon product validation failedProduct validation failed due to invalid conditions.All APIs
777User property validation failedUser property validation failed based on specified conditions.All APIs
777Selected items: No product property value matchedThe selected itemโ€™s properties do not match the coupon requirements.All APIs
777Applied coupon code is expiredThe applied coupon code has expired.Validate and Redeem APIs
777Coupon code or ID missing in the request bodyThe coupon code or ID is missing or invalid in the request body.Validate and Redeem APIs
777Non-redeemed coupon is revertedThe coupon cannot be reverted as it was never redeemed.Validate and Redeem APIs
777Coupon code or ID is invalidThe provided coupon code or ID is invalid or not found.Validate and Redeem APIs
777Validation is applied on metadata properties, but the key is not passed in the payloadThe required metadata key for validation is missing in the payload.Validate and Redeem APIs
777User is not logged in and is attempting to validate the campaign user couponThe user must log in or sign up before redeeming the coupon code.Validate and Redeem APIs
777Validation for selected items failedThe discount validation for selected items has been failed.Validate and Redeem APIs
777OrderStatus contains wrong valuesThe order status provided is invalid; it should be one of pending, completed, or reverted.Redeem API
777Duplicate orderId passedThe provided orderId has already been used for a previous transaction.Redeem/Revert API
400Query parameter not passedA required query parameter query_param_key is missing in the request.Redeem/Revert API
400Query parameter is wrongThe query parameter type must be either redeemed or reverted.Redeem/Revert API
777order and item object not passedBoth order and item objects are required in the request body.Redeem/Revert API
777Mandatory keys in item or order object not passedA mandatory key is missing from the order or item object.Redeem/Revert API
777order and item objects passed, but mandatory keys have empty valuesThe mandatory key value in the order or item object cannot be empty.Redeem/Revert API

Partner Voucher API Errors

Error CodesError CaseError BehaviorApplicable API
777Identity is valid, vouchers assignedReturns all vouchers tied to the identityFetch Voucher API
400Identity is not passedReturns HTTP 400 with "error": "Invalid identity"Fetch Voucher API
777Identity is valid, no vouchers assignedReturns empty records array with "status": "success"Fetch Voucher API

//kapa search bot