Error codes

Last updated: October 6, 2025

See the definitions of the error codes you may receive when integrating Flow for mobile.

Error	Description
`BASE64_ENCODING_FAILED`	The encoding of the `sessionData` passed to the `handleSubmit` callback failed.
`CALLBACK_NOT_PROVIDED`	You must provide the `onTokenized()` callback before you call the `tokenize()` method.
`CARD_AUTHENTICATION_FAILED`	The 3DS authentication challenge failed or was canceled for card payment. For example, when customers make a card payment and they cancel or fail the 3DS challenge.
`COMPONENT_INVALID`	The selected component's inputs are invalid. For the `Flow` component, this is also called if there are no embedded components selected.
`COMPONENT_IS_AVAILABLE_NOT_CHECKED`	The `isAvailable()` method was not called before rendering the `PaymentMethodComponent`. The component may not be supported by the customer's device. After you create the `PaymentMethodComponent`, call the `isAvailable()` method to verify that the device supports the payment method. This does not apply to the `CheckoutComponent`.
`COMPONENT_NOT_SUPPORTED`	The name specified when creating the `PaymentMethodComponent` using the `create()` method is not supported. If you provide `enabled_payment_methods` or `disabled_payment_methods` options when you create the payment session, ensure you also include the payment method that you want to offer. You must also ensure that the `currency` and `billing.address.country` values you provide to the payment session match the payment method's requirements.
`CONFIGURATION_INVALID`	After you create a payment session in your server-side integration, ensure you return the public key and the entire `PaymentSession` response object to the client-side and provide it to Flow for mobile.
`INVALID_SETUP`	The SDK was initialized or invoked with an invalid setup. For example: Missing or malformed `publicKey` Missing or partial payment session Calling methods in the wrong order Using unsupported configuration combinations Review your initialization of Flow for Mobile and the payment session payload, then re-create the session and retry.
`MERCHANT_HANDLE_SUBMIT_CALLBACK_FAILED`	The payment session submission sent with the `handleSubmit` callback failed.
`INVALID_SETUP`	The SDK was initialized or invoked with an invalid setup. For example: Missing or malformed `publicKey` Missing or partial payment session Calling methods in the wrong order Using unsupported configuration combinations Review your initialization of Flow for Mobile and the payment session payload, then re-create the session and retry.
`METHOD_NOT_SUPPORTED`	The `tokenize()` method is not supported for the selected component. For the `Flow` component, this is also called if a card component is not embedded.
`PAYMENT_METHOD_ATTEMPT_FAILED`	The payment attempt for the payment method specified in `details.type` encountered an unexpected failure. Unexpected failures may occur when Flow integrates with a payment method's client-side library, or makes network requests to the payment method's endpoints. If you persistently encounter the error for a specific payment method, this could be caused by your account configuration. For example, incomplete onboarding to a payment method. Contact your account manager or request support.
`PAYMENT_REQUEST_DECLINED`	The payment request was declined. The payment's ID is provided in the `details.paymentId` property. You can fetch the details of the payment by calling the Get payment details endpoint, or searching for the payment record in the Dashboard. The `details.requestErrorCodes` property contains one of the following error codes: `not_enough_funds` – The customer does not have enough funds for the transaction. `invalid_payment_session_data` – You provided invalid details when creating the payment session. See the API reference for additional field details. `invalid_customer_data` – The customer provided invalid details. `merchant_misconfiguration` – Your account has invalid configurations. `try_again` – The payment request was declined due to technical issues. Contact your account manager or request support. Flow automatically displays error messages to the customer, with suggested next actions to improve retry success.
`PAYMENT_REQUEST_FAILED`	The payment request failed due to unexpected error or network issue. Any additional error codes from the network requests are provided in the `details.requestErrorCodes` property. See the possible error codes for the Request a payment endpoint for more details. Customers can typically complete their payment after a retry. If you persistently encounter the error for a specific payment method, this could be caused by your account configuration. Contact your account manager or request support.
`PAYMENT_SESSION_FAILED`	The payment session request failed due to unexpected error or network issue. If you persistently encounter the error for a specific payment method, contact your account manager or request support.
`SERVER_COMMUNICATION_ERROR`	A required backend response could not be retrieved due to a network or server issue. Check connectivity and server availability, inspect any attached request error details, and retry. If the issue persists, contact your account manager or request support.
`SUBMISSION_PARSE_ERROR`	The result of the payment submission could not be parsed.
`UPDATE_PARAMETER_INVALID`	The `updateDetails` passed to the `CheckoutComponents.update()` method contains invalid values.
`VALIDATION_FAILED`	One or more input values failed client-side validation for the selected component. Ensure all required fields are present and correctly formatted, update the inputs, and retry the operation.