JavaScript is disabled. Some features may not work. You can also read the static version: View text version

SDK Error Codes

The following table lists client/server error codes that the Hypercheckout SDK returns in response to calls.

For any other error codes and error message that is not part of the below list, merchant needs to handle the next steps after polling with Juspay Backed

Order Status doc for reference: https://juspay.io/in/docs/api-reference/docs/express-checkout/order-status-api

Scroll inside to view more

Error Codes	Sample Error Message	Description	Error Handling
JP_000	Reason not available, error	New orders/Uncategorised SDK errors	Contact Juspay Support
JP_001	Unable to parse response	This is mainly caused due to API failures or an incorrect business logic.	Please ensure that all parameters are passed as per documentation. Please ensure that order creation was completed for the particular order ID that was passed for the transaction call (applicable if you are required to create order through server to server call).
JP_002	User_aborted	This error code is received when an user backpressed after landing on Bank OTP page/ Netbanking Login page/ Wallet Redirection page.	Allow user to retry the payment.
JP_003	{ "payload": { "cardExpYear": "Type mismatch: expected String, found Undefined" } }	This is an Integration error caused due to type mismatch in parameters. The error message will state the parameter name and expected type.	Please refer the integration documentation and verify the request parameters and their type.
JP_004	Chrome custom tabs not found. Please add it to your dependencies	Dependencies (will be mentioned in the error message) are not added.	Add the respective dependency in SDK.
JP_005	No internet	User is not connected to the internet.	Allow user to retry the payment.
JP_006	Transaction status is awaited	Delay in updation of transaction status. Awaiting response from PG.	Invoke the Juspay Order Status API to check the status.
JP_007	Page not found	Unable to redirect to a valid URL to proceed with transaction	Check dashboard configuration (or) Contact Juspay Support
JP_008	Card params not found, Sdk params not found etc.	Mandatory configurations on Juspay dashboard are incorrect/incomplete	Check dashboard configuration (or) Contact Juspay Support
JP_009	Submit OTP allowed is false	This is an error specific to Native OTP flow, where the user had exceeded the limit of incorrect OTP submissions. This will mostly lead to issuer blocking the users' card.	Allows user to retry payment with different payment method.
JP_010	Gpay fallback feature is unsupported	Hyper SDK configurations for your Merchant ID are incomplete/ incorrect	Contact Juspay Support
JP_011	Internal server error	Server error	Contact Juspay Support
JP_012	Transaction Failed at bank end.	Transaction failure at PG end. The error message sent by the respective PG for various use cases will be passed for corrective action.	Allow user to retry the payment. Take corrective action to reduce such errors by getting in touch with respective PG
JP_013	Payment timed out	This is provided when UPI Collect waiting screen is timeout	Invoke the Juspay Order Status API to check the status.
JP_014	Startactivity in background failed, CCT activity timeout	Minimised before launching cct activity	CCT cannot be opened if app is in background. Also CCT force timeouts after 180 sec
JP_015	Cred App is not present in device	Transaction can not go through the cred application	Take appropriate action, give user message 'Cred App is not present on your device'
JP_016	Some error occured in Juspay Safe Mode	Juspay Safe Mode could not rescue the transaction	Reinitiate the payment
JP_017	initiate() can only be called once without terminate()	Initiate was called multiple times on an instance before terminating the SDK	Using isInitialised() to check whether the SDK has been initiated or not
JP_018	Signature expired / invalid signature	The signature sent in SDK payload is either invalid or has expired (More than 180 mins)	Contact Juspay Support
JP_019	JUSPAY_DECLINED	Transaction is declined from Juspay server end	Contact Juspay Support
JP_020	Customer creation is failing	Customer creation failed at Juspay backend	Contact Juspay Support
JP_022	Network Call Timeout	This is provided when Juspay SDK has not received response from Juspay server within set time period	Allow user to retry the payment.
JP_023	Transaction Money will be Refunded	Money is autorefunded from Juspay End.	Consume it as per your required usecase.This typically occurs in scenarios such as the verification of the user account with penny drop transaction or the configuration of mandate register setups, which are enabled following discussions between the merchant and Juspay.
JP_851	Notification Failed	This mainly comes when transaction has failed in notification leg, will start with PDN Failed.	Notification for mandate payment failed, please attempt order for the payment again.
JP_852	Mandate in inactive	This error will come when we try to do a recurring transaction on an inactive mandate.	Setup a new mandate if in Revoked or Expired state, try unpausing the mandate if in paused state.