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

SDK Error Codes

Sample Error Payload

SDK errors will be received in the following format:

Scroll inside to view more

Key	Type	Description
requestId	String	A unique randomly generated unique string for triggering any operation on HyperSDK. Usually used to match if response or callbacks are triggered for the same operation. Should be a UUID string. Click here for reference.
service	String	A reference to the Juspay product being consumed
payload	String	Contains all relevant information required to complete an operation in input or output of an operation in output.
error	Boolean	Root key to identify if an operation triggered on SDK was successful or failure.
errorCode	String	A set of defined codes for errors triggered for different cases for SDK.
errorMessage	String	Details about the error message to help figure out integration or transactional issues.

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

Juspay Errors

Scroll inside to view more

Error Codes	Description	Error Handling	Sample Error Messages
JP_000	Reason Unavailable	Contact Juspay Support	Unknown Exception
JP_001	This is mainly caused due to 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).	Unknown event : event_name User Denied Permission Error while fetching permissions Unable to fetch sims Timed Out Exit : Error Status not matched status (NOPERMISSION / FRESH / BOUND / LINKED)
JP_002	This error code is received when a user backpressed.	Allow user to retry the payment.	USER_ABORTED
JP_003	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 this documentation and try verifying the parameters and it's type.	Wrong/Missing params Initiate was failure Unknown Operation Invalid Account Reference ID An order with same OrderId already exists. Sdk params not found in response Order Id not found. Wrong/Missing params: issuing_psp is missing Action Unmatched Mandatory Parameter: Type mismatch: expected String, found Undefined Unknown action: action
JP_004	User based errors.	Please ask the user to perform respective actions required.	Not eligible for inapp Unknown Exception Sim cards not available Please turn off Airplane mode Sim card is not ready Unable to send SMS Mobile Data is Off Activity was sent to background
JP_005	User is not connected to the internet.	Ask user to connect to the internet.	No internet
JP_006	Delay in updation of transaction status. Awaiting response from PG.	Invoke the Juspay Order Status API to check the status.	Transaction status is awaited
JP_007	Unable to redirect to a valid URL to proceed with transaction Not specific to UPI	Contact Juspay Support	Page not found
JP_008	Mandatory configurations on Juspay dashboard are incorrect/incomplete	Check dashboard configuration (or) Contact Juspay Support	Sdk params not found in response Unable to fetch sdk version. Please check if resource is present Invalid account referenceId Unable to fetch device details Invalid account reference id Mpin not set Invalid Vpa Invalid account reference id/ Vpa / Mpin not set registerUPILiteARPC failure liteDeregister failure NPCI Token is missing Session token call not found Auth Missing Unable to fetch sims Maximum 2 vpas can be linked to an account. Invalid account referenceId
JP_009	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. Not specific to UPI	Allows user to retry payment with different payment method.	Submit OTP allowed is false
JP_010	Feature is not supported	Contact Juspay Support	Feature not supported at the moment
JP_011	Server error	Contact Juspay Support	INTERNAL_SERVER_ERROR
JP_012	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	Transaction Failed at bank end. There was a problem fetching the UPI session. Unable to process API No Linked accounts found No Customer Id found No Vpa Accounts Linked Could not fetch customer info Could not update upi number Could not check upi number status Could not fetch customer info Could not create upi number Mobile number not eligible for UPI Could not link account. Could not get permission. Could not check balance. Could not set mpin. Mandate creation failed at bank end. UPI ID is not registered. Integration error creds response mismatch. Integration error creds could not be fetched. API failure : reason unknown
JP_014	Minimised before launching cct activity Not specific to UPI	CCT cannot be opened if app is in background. Also CCT force timeouts after 180 sec	Startactivity in background failed, CCT activity timeout
JP_015	Transaction can not go through the cred application Not specific to UPI	Take appropriate action, give user message 'Cred App is not present on your device'	Cred App is not present in device
JP_016	Juspay Safe Mode could not rescue the transaction Not specific to UPI	Reinitiate the payment	Some error occured in Juspay Safe Mode
JP_017	Initiate was called multiple times on an instance before terminating the SDK	Using isInitialised() to check whether the SDK has been initiated or not	initiate() can only be called once without terminate()
JP_018	Required permissions to run SDK does not exists	Allow users to grant those permissions	Permission Failure No Permission
JP_019	When NPCI CL does not return the challenge or throws a technical error	Retry or contact the Juspay team	UPI Technical Failure

Sub Error Codes

These are the error codes that is sent inside the payload of responses. Sample JSON:

Scroll inside to view more

Process API	Sub Error Code	ERROR MESSAGE
upiBindActivateDevice	APP_TOGGLED	-