Error Codes

GoPayEnterpriseError

Represents an error returned by the SDK.

Field nameTypeDescription
codeStringEnterprise Error constant specifying the exact error being observed during initialization etc.
messageStringLocalized Error message
titleStringLocalized Error Title
ValueDescriptionRetriableAction by Client
GPE-2201The SDK configuration is invalid or missing required fields.NoEnsure GoPayEnterpriseConfig is properly configured before initializing the SDK.
GPE-2202The token passed by the client is expired or unauthorized.YesRefresh the token on your backend and retry the flow with an updated token.
GPE-2203There was a connection error while connecting to the network service.YesKYC flow: Retry the flow; if the issue persists, check the device's network connectivity. Other flows: Not required — the SDK already shows a dialog. No client action needed.
GPE-2204Feature is not whitelisted.NoContact the GoPay team to verify feature entitlements for your clientID.
GPE-2205Unknown error.NoReport the full GoPayEnterpriseError (code, title, message) to the GoPay team.
GPE-2206The request is missing required fields (requestId or userCorrelationId).NoEnsure both fields are non-blank before calling verify().
GPE-2207User cancelled or dropped out of the flow.YesKYC flow: Prompt the user to restart the flow if needed. Other flows: No action required.
GPE-2208Credential exchange failed. The exchange handler returned ExchangeResult.Failure.NoCheck error.message for the reason string from ExchangeResult.Failure; fix the backend exchange.
GPE-2209Credential exchange timed out. The exchange handler did not return within the allowed time.YesEnsure the exchange handler completes promptly; check for network or backend latency.
GPE-2210Camera is unavailable or could not be accessed during the flow (e.g. KYC document scan).YesPrompt the user to check camera availability and retry the flow.
GPE-2211A required permission was denied by the user (e.g. camera during KYC).YesPrompt the user to grant the required permission in device settings and retry the flow.
GPE-2212The verification process failed (e.g. liveness or document check failed during KYC).YesPrompt the user to retry the flow.
GPE-2213User navigated away from the flow by tapping the Help button (e.g. during KYC).YesNo action required; the user chose to exit the flow voluntarily.
GPE-2214A security check failed during the flow (e.g. rooted or tampered device detected during KYC).NoNo action required — the SDK blocks the flow on unsupported devices.
GPE-2215An API error occurred during a network request in the flow (e.g. during KYC).YesRetry the flow; if the issue persists, report the GoPayEnterpriseError to the GoPay team.