Overview

Proper error handling is essential, as it ensures that your application can gracefully manage unexpected situations, provide meaningful feedback to users, and maintain system stability while protecting sensitive data.

When an error occurs, you'll receive an error code (SDKXXXX) and descriptive error message.

Error codes

The following table describes all the possible SDK errors codes, sorted by error type.

Error code	Description	Error type
`SDK0000`	Unexpected error.	Common error.
`SDK0001`	Not implemented.	Common error.
`SDK0100`	Missing SDK Config.	SDK error.
`SDK0101`	Missing SDK Config: `Environment`.	SDK error.
`SDK0102`	Missing SDK Config: `SessionData`.	SDK error.
`SDK0103`	Missing SDK Config: `SessionData.Id`.	SDK error.
`SDK0104`	Missing SDK Config: `SessionData.Hmackey`.	SDK error.
`SDK0105`	Unsupported payment method type `'{type}'`.	SDK error.
`SDK0106`	Intent type `'{type}'` not support component `'{componentType}'`.	SDK error.
`SDK0107`	Card is missing in allow funding types.	SDK error.
`SDK0200`	Component name must not be empty.	Component error.
`SDK0201`	Container element with id '`{id}'` not found.`	Component error.
`SDK0304`	Token vault error.	Token Vault error.
`SDK0400`	Currency code must be 3 characters.	ThreeDSecure error (pre-initiate integrated authentication).
`SDK0401`	Fingerprint callback URL is required.	ThreeDSecure error (pre-initiate integrated authentication).
`SDK0402`	Acquirer profile ID must be 0 or 36 characters.	ThreeDSecure error (pre-initiate integrated authentication).
`SDK0403`	Provider ID must be 0 or 36 characters.	ThreeDSecure error (pre-initiate integrated authentication).
`SDK0404`	Gateway token ID must be 36 characters.	ThreeDSecure error (pre-initiate integrated authentication).
`SDK0405`	Scheme token ID must be 36 characters.	ThreeDSecure error (pre-initiate integrated authentication).
`SDK0406`	Card token ID is required.	ThreeDSecure error (pre-initiate integrated authentication).
`SDK0407`	Currency `'{currencyCode}'` does not accept decimal places.	ThreeDSecure error (pre-initiate integrated authentication).
`SDK0408`	Invalid decimal places for `'{currencyCode}'`. Expected `'{expectedExponent}'` decimal places, got '`{actualExponent}'`.	ThreeDSecure error (pre-initiate integrated authentication).
`SDK0409`	Country numeric code is invalid.	ThreeDSecure error (initiate integrated authentication).
`SDK0410`	Merchant legal name is invalid.	ThreeDSecure error (initiate integrated authentication).
`SDK0411`	Challenge window size is invalid.	ThreeDSecure error (initiate integrated authentication).
`SDK0412`	Challenge callback URL is required.	ThreeDSecure error (initiate integrated authentication).
`SDK0413`	Accept header is required.	ThreeDSecure error (initiate integrated authentication).
`SDK0414`	Invalid language format. Must be a valid IETF BCP 47 language tag.	ThreeDSecure error (initiate integrated authentication).
`SDK0415`	Screen height is invalid.	ThreeDSecure error (initiate integrated authentication).
`SDK0416`	Screen width is invalid.	ThreeDSecure error (initiate integrated authentication).
`SDK0417`	Email is invalid.	ThreeDSecure error (initiate integrated authentication).
`SDK0418`	Recurring expiration date is invalid.	ThreeDSecure error (initiate integrated authentication).
`SDK0419`	Recurring frequency in days is invalid.	ThreeDSecure error (initiate integrated authentication).
`SDK0420`	IP address is invalid.	ThreeDSecure error (initiate integrated authentication).
`SDK0421`	Requestor challenge indicator is invalid.	ThreeDSecure error (initiate integrated authentication).
`SDK0500`	Network error.	Transaction error.
`SDK0501`	Validation error.	Transaction error.
`SDK0502`	Pre-Initiate Authentication failed.	Transaction error.
`SDK0503`	Authentication rejected. Please try again or contact your bank for assistance.	Transaction error.
`SDK0504`	Authentication failed. `ScaException` is required.	Transaction error.
`SDK0505`	Authentication failed. Please try again or contact your bank for assistance.	Transaction error.
`SDK0506`	Authentication failed. `ScaException` must be one of the following: `'AnonymousCard'`, `'LowValue'`, `'SecureCorporate'`, `'TransactionRiskAnalysis'`, `'TrustedBeneficiary'`.	Transaction error.