--- title: List of Error Codes slug: developer-tools/error-codes/list excerpt: Explore the list of error codes returned through Pine Labs Online APIs. hidden: false metadata: title: "Complete Payment Error Code List | Pine Labs Developer Reference" description: >- Comprehensive list of Pine Labs payment error codes across all methods. Includes reasons, descriptions, and solutions for transaction errors, authentication failures, card issues. keywords: "payment error codes, API error list, transaction errors, error code reference, payment failure codes, integration errors" robots: index sidebar_order: 2 --- 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 |