List of Error Codes
The table below lists the top error codes associated with various payment methods, along with their corresponding reasons and descriptions.
| Code | message | Status Code | Source |
|---|---|---|---|
INTERNAL_ERROR | Internal server error. The request cannot be processed at this time | 500 | INTERNAL |
DUPLICATE_REQUEST | The request has already been processed | 422 | INTERNAL |
USER_AUTHENTICATION_FAILED | User Authentication Failed, Please try again with valid parameters. | 422 | INTERNAL |
AMOUNT_LIMIT_EXCEEDED | The transaction was declined because the specified amount exceeds allowed limits | 422 | ACQUIRER |
CARD_EXPIRED | Specified card is not allowed for this transaction because it has expired | 422 | ACQUIRER |
CARD_LOST | Specified card is not allowed for this transaction because it was flagged as lost | 422 | ACQUIRER |
CARD_NOT_ALLOWED | Specified card is not allowed for this transaction | 422 | ACQUIRER |
CARD_NOT_ENROLLED | Specified card is not allowed for this transaction because it is not enrolled for 3DS | 422 | ACQUIRER |
CARD_STOLEN | Specified card is not allowed for this transaction because it was flagged as stolen | 422 | ACQUIRER |
CARD_VERIFICATION_FAILED | Invalid CVV specified on the card payment option | 422 | ACQUIRER |
INSUFFICIENT_FUNDS | Insufficient funds to proceed with payment using the specified payment option | 422 | ACQUIRER |
INVALID_CARDHOLDER | Invalid card holder specified on the card payment option | 422 | ACQUIRER |
INVALID_INSTRUMENT | The payment instrument details are not valid | 422 | ACQUIRER |
INVALID_REQUEST | The request does not the expected contract and cannot be processed. This may be due to malformed request, invalid or missing parameters | 400 | INTERNAL/ACQUIRER |
INVALID_USER_ACCOUNT | Relevant User Account not active/valid | 422 | INTERNAL |
ISSUER_NOT_SUPPORTED | The specified issuer is not supported for this operation | 422 | INTERNAL |
PAYMENT_DECLINED | The payment was declined by the acquirer | 422 | ACQUIRER |
PAYMENT_EXPIRED | The payment has expired and cannot be modified further | 422 | ACQUIRER |
PAYMENT_METHOD_NOT_ENABLED | The specified payment method is not enabled for the merchant | 422 | INTERNAL |
PAYMENT_NOT_AUTHORIZED | The payment requires authorization before it can be processed | 422 | ACQUIRER |
PAYMENT_RATE_LIMIT | The payment was declined because too many payments were attempted using the specified payment option | 422 | ACQUIRER |
RISK_CHECK_FAILED | The payment was declined after a risk check | 422 | INTERNAL/ACQUIRER |
TIMED_OUT | The request timed out. Please try again latet. | 422 | INTERNAL/ACQUIRER |
UNAUTHORIZED | The client is not authorized to perform this operation | 422 | INTERNAL/ACQUIRER |
USER_UNAUTHORIZED | the user is not authoirzed to do the transaction | 400 | ACQUIRER |
UNKNOWN_ERROR | Failure due to Unknown reason | 422 | ACQUIRER |
OPERATION_NOT_ALLOWED | Refund not allowed on this order type | 422 | ACQUIRER |
API_RATE_LIMIT | Failure due to allowed attempts exceeded | 422 | ACQUIRER |
INCORRECT_OTP | the OTP submitted is incorrect | 400 | ACQUIRER |
TRANSATION_NOT_ALLOWED | the user needs to sign up first on the application. | 400 | ACQUIRER |
OTP_EMPTY | otp can not be empty | 400 | processor/gateway |
EMPTY_REQUEST | Empty object sent | 400 | processor/gateway |
EMPTY_MOBILE_NUMBER | Mobile number empty | 400 | processor/gateway |
EMPTY_AMOUNT | amount can not be empty | 400 | processor/gateway |
NEGATIVE_AMOUNT | amount should be greater than zero | 400 | processor/gateway |
CURRENCY_REQUIRED | currency is required | 400 | processor/gateway |
ELIGIBILITY_RESPONSE_ID_EMPTY | something is missing in the request | 400 | processor/gateway |
EMPTY_MERCHANT_DETAILS | merchant details are empty | 400 | processor/gateway |
EMPTY_MERCHANT_ID | merchant id is not mentioned | 400 | processor/gateway |
EMPTY_MERCHANT_ORDER_REFERENCE | something is missing in the request | 400 | processor/gateway |
EMPTY_REFUND_PAYMENT_ID | refund payment id is not present in the request | 400 | processor/gateway |
EMPTY_PAYMENT_ID | payment id is not present | 400 | processor/gateway |
EMPTY_TRANSACTION_REFERENCE | something is missing in the request | 400 | processor/gateway |
EMPTY_PAYMENT_TYPE | payment type is empty | 400 | processor/gateway |
LAZY_PAY_SERVICE_UNAVAILABLE | some error occured on the acquirer end | 500 | processor/gateway |
MERCHANT_NOT_VALID | merchant is not valid | 400 | processor/gateway |
AMOUNT_INVALID | amount is incorrect | 400 | processor/gateway |
PAYMENT_ID_INVALID | payment id is incorrect | 400 | processor/gateway |
INQUIRY_REQUEST_WRONG | inquiry request is not set properly. | 400 | processor/gateway |
INTERNAL_ERROR_OCCURED | some internal error occured | 422 | processor/gateway |
ORDER_NOT_FOUND | Order not found | 404 | ACQUIRER |
INVALID_MERCHANT | The payment was declined by the card issuer on this merchant | 422 | ACQUIRER |
ORDER_CANCELLED | The order has already been cancelled and cannot be modified further. | 422 | ACQUIRER |
ISSUER_NOT_AVAILABLE | The payment was declined as issuer was not available | 422 | ACQUIRER |
REFUND_LIMIT | The maximin refund limit rfund reached | 422 | ACQUIRER |
INVALID_CARD | The card number or details entered seem incorrect. | 422 | INTERNAL |
CARD_NOT_ELIGIBLE_FOR_EMI | This card doesn't support EMI or offer options. | 422 | INTERNAL |
CUSTOMER_NOT_ELIGIBLE_FOR_EMI | You're not eligible for this EMI or offer. | 422 | INTERNAL |
PRODUCT_ALREADY_SOLD | Product not available for this transaction. | 422 | INTERNAL |
OFFER_EXPIRED | The selected offer has expired. | 422 | INTERNAL |
DC_CREDIT_LIMIT_BLOCKING_FAILED | Your card limit could not be blocked. | 422 | INTERNAL |
DC_CREDIT_LIMIT_UNBLOCKING_FAILED | Card limit release failed. | 422 | INTERNAL |
CUSTOMER_CARDLESS_BLOCKING_FAILED | Unable to block credit limit for cardless EMI. | 422 | INTERNAL |
CUSTOMER_CARDLESS_UNBLOCKING_FAILED | Unable to release credit hold after cancellation. | 422 | INTERNAL |
VELOCITY_BLOCKING_FAILED | Card or account spending limits exceeded. | 422 | INTERNAL |
VELOCITY_UNBLOCKING_FAILED | Unable to reset usage limits. | 422 | INTERNAL |
VOID_TRANSACTION_FAILED | We couldn't cancel this transaction. | 422 | INTERNAL |
GRANT_LOAN_FAILED | Couldn't complete EMI booking. | 422 | INTERNAL |
CANCEL_LOAN_FAILED | Cancelling the EMI booking failed. | 422 | INTERNAL |
REFUND_LOAN_FAILED | Refund wasn't processed successfully. | 422 | INTERNAL |
ELIGIBILITY_CHECK_FAILED | You're not eligible for the selected EMI/offer. | 422 | INTERNAL |
SEND_PAYMENT_LINK_FAILED | We couldn't send you the payment link. | 422 | INTERNAL |
DC_CREDIT_LIMIT_CHECK_FAILED | Couldn't verify debit card limits. | 422 | INTERNAL |
CREDIT_LIMIT_CHECK_FAILED | Credit card balance couldn't be verified. | 422 | INTERNAL |
CARD_CREDIT_LIMIT_CHECK_FAILED | Credit card limit verification failed. | 422 | INTERNAL |
VELOCITY_CHECK_FAILED | Too many transactions or volume used. | 422 | INTERNAL |
PRODUCT_VALIDATION_FAILED | Product info seems incorrect. | 422 | INTERNAL |
IMEI_VALIDATION_FAILED | Problem validating device IMEI. | 422 | INTERNAL |
IMEI_BLOCK_FAILED | Unable to secure device for EMI. | 422 | INTERNAL |
DC_CREDIT_LIMIT_CHECK_REQUIRED | Limit verification incomplete; action needed. | 422 | INTERNAL |
VELOCITY_CHECK_REQUIRED | Spend/transaction monitoring required. | 422 | INTERNAL |
TXN_EXPIRED | Your transaction session expired due to inactivity. | 422 | INTERNAL |
INVALID_RESPONSE_RECEIVED_FOR_PRODUCT_BLOCK | Couldn't lock the product on selection. | 422 | INTERNAL |
PRODUCT_DETAILS_NOT_PRESENT | Product details are incomplete or invalid. | 422 | INTERNAL |
PRODUCT_AMOUNT_NOT_PRESENT | Something wrong with product pricing. | 422 | INTERNAL |
ISSUER_ID_NOT_FOUND | Bank or issuer doesn't support this offer. | 422 | INTERNAL |
ACQUIRER_DETAILS_NOT_FOUND | Payment acquirer not supported for this transaction. | 422 | INTERNAL |
MOBILE_NUMBER_NOT_PRESENT | Mobile number needed for EMI/payment. | 422 | INTERNAL |
ALLOWED_TXN_COUNT_CONSUMED | Offer already used with this card/customer. | 422 | INTERNAL |
ALLOWED_TOTAL_COMBINED_TXN_COUNT_CONSUMED | Multiple offers used already with this card. | 422 | INTERNAL |
ALLOWED_TOTAL_SUBVENTION_TXN_COUNT_CONSUMED | Subvention-based transactions exceeded. | 422 | INTERNAL |
ALLOWED_TOTAL_DISCOUNT_TXN_COUNT_CONSUMED | You have reached your discount quota. | 422 | INTERNAL |
INVALID_REFUND_AMOUNT | The amount can't be refunded as entered. | 422 | INTERNAL |
INVALID_SETTLE_AMOUNT | Issue with transaction amount. | 422 | INTERNAL |
OTP_VALIDATION_FAILED | Incorrect OTP entered. | 422 | INTERNAL |
SEND_OTP_FAILED | Couldn't send OTP. | 422 | INTERNAL |
AGGREGATED_REFUND_AMOUNT_EXCEEDED | Allowed refund threshold crossed. | 422 | INTERNAL |
REFUND_DURATION_EXCEEDED | Time limit for refund has passed. | 422 | INTERNAL |
PROGRAM_TYPE_NOT_PRESENT | The required EMI/offer type is not configured for this merchant. | 422 | INTERNAL |
INVALID_VOID_AMOUNT | Cancellation amount exceeds or doesn't match original value. | 422 | INTERNAL |
AGGREGATED_VOID_AMOUNT_EXCEEDED | Combined refund value is more than original transaction. | 422 | INTERNAL |
AGGREGATED_PRODUCT_AMOUNT_EXCEEDS_LOAN_AMOUNT | Total cart value is higher than approved EMI loan. | 422 | INTERNAL |
IMEI_UNBLOCK_FAILED | The product couldn't be unlocked for new EMI. | 422 | INTERNAL |
IMEI_UNBLOCK_EXCEPTION_OCCURRED | A system issue occurred while unblocking this product. | 422 | INTERNAL |
PRODUCT_ALREADY_UNBLOCKED | The product is already released and available for EMI. | 422 | INTERNAL |
PRODUCT_NOT_BLOCKED | This product was never locked for EMI and can't be unblocked. | 422 | INTERNAL |
PRODUCT_ALREADY_BLOCKED | This product is already sold or tied to a prior EMI. | 422 | INTERNAL |
DIFFERENT_BRAND_PRESENT | EMI transaction supports only one brand in cart. | 422 | INTERNAL |
INVALID_TXN_AMOUNT | Order amount doesn't qualify for EMI. | 422 | INTERNAL |
INVALID_PRODUCT_AMOUNT | One or more products have mismatched prices. | 422 | INTERNAL |
INVALID_PRODUCT_BRAND_EMI | This brand is not eligible for EMI offers. | 422 | INTERNAL |
OFFER_NOT_CONFIGURED | Merchant has no active offers set. | 422 | INTERNAL |
UNPROCESSABLE_ENTITY | The transaction couldn't be processed. | 422 | INTERNAL |
BUYBACK_NOT_ENABLED | Buyback is not available for this product. | 422 | INTERNAL |
INVALID_PRODUCT_DETAILS | Product info is missing or incorrect. | 422 | INTERNAL |
OFFER_EXPIRED_OR_INVALID | The selected offer is no longer valid. | 422 | INTERNAL |
PROGRAM_TYPE_NOT_ENABLED | EMI or Offer program type is inactive. | 422 | INTERNAL |
PAYMENT_OPTION_DETAILS | Payment method info is invalid or incomplete. | 422 | INTERNAL |
BIN_NOT_FOUND | Card network could not be recognized. | 400 | INTERNAL |
OFFER_DETAILS_NOT_VALID | Offer details issuer parameters are invalid | 422 | INTERNAL |
PAR_NOT_FOUND | Card token couldn't be matched to a card. | 400 | INTERNAL |
INVALID_LOAN_AMOUNT | EMI loan amount is not valid. | 422 | INTERNAL |
INVALID_ORDER_AMOUNT | Total amount is not eligible for EMI. | 422 | INTERNAL |
INVALID_PAYMENT_METHOD | This payment method is not supported for EMI. | 422 | INTERNAL |
PHONE_NUMBER_IS_NOT_PRESENT | A valid mobile number is required to check eligibility for EMI offers in Cardless schemes. | 422 | INTERNAL |
OTHER_ISSUER_NOT_ALLOWED_WITH_CARDLESS_ISSUER_TYPE | You cannot combine cardless EMI with another card-based EMI in one transaction. | 422 | INTERNAL |
INVALID_DOWN_PAYMENT_AMOUNT | The entered down payment is too high and exceeds the allowed percentage of the total price. | 422 | INTERNAL |
PRODUCT_ALREADY_SKIPPED | Product is already skipped. | 422 | INTERNAL |
PERFORM_IMEI_NOT_APPLICABLE | Perform-imei not applicable as one of the requested product is not present in the system. | 422 | INTERNAL |
SKIP_IMEI_NOT_APPLICABLE | Skip-imei not applicable as the requested product is not present in the system. | 422 | INTERNAL |
VELOCITY_RULE_NOT_APPLICABLE_ON_PRODUCT | Any velocity rule is not applicable on this product. | 422 | INTERNAL |
EXTERNAL_VELOCITY_RULE_MAPPING_NOT_PRESENT | Velocity Rule is not present for this Brand. | 422 | INTERNAL |
SERIAL_NUMBER_MODEL_MISMATCH | The serial number does not match the product model provided. | 422 | INTERNAL |
SERIAL_NUMBER_NOT_VALIDATED | Serial number validation could not be completed for this product. | 422 | INTERNAL |
IMEI_BLOCKING_NOT_ALLOWED | Imei Blocking can't be performed on REFUNDED/VOIDED state | 422 | INTERNAL |
IMEI_BLOCKING_NOT_ALLOWED_ALL_INSTANCES_PAID_BACK | Imei blocking can't be performed as all the instances for the product are REFUNDED/VOIDED | 422 | INTERNAL |
MINIMUM_ONE_FIELD_REQUIRED_UNDER_CONVENIENCE | Convenience fee is not present in the system. | 422 | INTERNAL |
IMEI_SKIPPING_NOT_ALLOWED | Imei Skipping can't be performed on REFUNDED/VOIDED state | 422 | INTERNAL |
IMEI_VALIDATION_NOT_APPLICABLE | IMEI validation is not applicable for the requested product. | 422 | INTERNAL |
OFFER_BUDGET_EXCEEDED | Offer budget exceeded for the requested offer. Please try again with different offer. | 422 | INTERNAL |
UPI_VPA_FETCH_FAILURE | There is an issue in VPA fetch service. Please try again later. | 422 | INTERNAL |
INVALID_SERIAL_NUMBER | This Serial number is invalid | 422 | INTERNAL |
ORDER_ALREADY_UNBLOCKED | The product is already unblocked. | 422 | INTERNAL |
ORDER_ALREADY_BLOCKED | This product is already blocked. | 422 | INTERNAL |
ORDER_UNBLOCK_NOT_ALLOWED | Unblocking this order is not permitted for the requested action. | 422 | INTERNAL |
MISSING_REQUIRED_PARAMETER | The transaction request is incomplete. | 400 | INTERNAL |
IMEI_DOES_NOT_BELONG_TO_DEALER | The entered IMEI does not belong to dealer. | 422 | INTERNAL |
INVALID_DEALER_CODE | Dealer code is invalid or inactive. | 422 | INTERNAL |
INVALID_STORE_ID | Store ID is invalid or inactive. | 422 | INTERNAL |
INVALID_REQUEST_TYPE | The request type is not supported for this endpoint. | 422 | INTERNAL |
INVALID_PAYMENT_TYPE | The chosen payment type is not supported. | 422 | INTERNAL |
INVALID_RESPONSE_FROM_BRAND | We received an invalid response from the brand. | 422 | INTERNAL |
INSUFFICIENT_STOCK | The requested product is out of stock. | 422 | INTERNAL |
SKU_NOT_FOUND | The requested SKU is not present in inventory. | 422 | INTERNAL |
INVALID_SKU_CODE | The SKU code provided seems incorrect. | 422 | INTERNAL |
UPI_VPA_NOT_FOUND | VPA not found for provided registered mobile number | 422 | INTERNAL |
VPA_MISMATCH | Provided VPA does not match with registered VPA | 422 | INTERNAL |
MAPPING_ERROR | Error occurred while mapping the response. | 422 | INTERNAL |
TOKEN_NOT_FOUND | The provided token could not be found. | 422 | INTERNAL |
BAD_REQUEST | Product Mismatch with the order | 400 | INTERNAL |
BIN_NOT_ELIGIBLE_FOR_OFFER | This card is not eligible for the selected offer. | 422 | INTERNAL |
PRODUCT_BLOCKING_FAILED | Product is unavailable or already linked to another transaction. | 422 | INTERNAL |
PRODUCT_CODE_NOT_PRESENT | Product is missing or not linked to EMI/offer. | 422 | INTERNAL |
REFUND_NOT_ALLOWED_FOR_ISSUER | Refund can't be done on this card. | 422 | INTERNAL |
INVALID_BLOCK_UNBLOCK | The EMI block/unblock action requested is invalid. | 422 | INTERNAL |
PRODUCT_INSTANCE_EXHAUSTED | Product has been used maximum allowed times for EMI/offers. | 422 | INTERNAL |
MULTIPLE_CONVENIENCE_FEE_ON_ISSUER_TYPE_FOUND | The system found more than one fee setup for the selected card type, which is not allowed. | 422 | INTERNAL |
CARDLESS_OFFER_IS_NOT_PRESENT | No offers available for the selected mobile number or payment provider. | 422 | INTERNAL |
PRODUCT_SERIAL_NUMBER_MISMATCH | Product serial number mismatch/not-present for one of the requested product id. | 422 | INTERNAL |
UNBLOCK_NOT_ALLOWED | Unblocking this product isn't allowed in its current state. | 422 | INTERNAL |
BUMPED_UP_CASHBACK_APPLIED | Cashback is already applied and can't be combined with this offer. | 422 | INTERNAL |
OFFER_VALIDATION_FAILED | Invalid offer selected. | 422 | INTERNAL |
PAYMENT_PENDING | The payment is pending and requires authorization before it can be processed | 422 | ACQUIRER |
Updated 25 days ago
Assistant
How do I implement webhook notifications for payment status updates, and what's the recommended way to verify webhook authenticity?
How do I integrate Pine Labs payment gateway with my React Native mobile app and what are the required API credentials?
Can I customize the payment UI for card transactions, and what parameters can I pass to modify the checkout experience for my customers?
Assistant