Error codes

Last updated: March 19, 2025

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

Error	Description
`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.
`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.