List of Error Codes
Explore the list of error codes returned through Pine Labs Online APIs.
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 about 5 hours 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