CheckoutError
Last updated: September 3, 2025
The Flow CheckoutComponents.Error.errorCode struct conforms to standard Swift LocalizedError protocol.
There are four types:
integrationrequestpaymentMethodsubmitvalidation
Each of them contains the following properties:
| Property | Type | Description |
|---|---|---|
|
| A human-readable description of the error. The description is subject to change. For example, to improve clarity. To ensure you catch errors correctly, reference the values returned by the type and code fields instead. |
|
| A code representing the error. To see how to resolve it, see Error codes. |
|
| Additional error properties. All error types return the following properties in the
|
Integration errors are caused by an invalid use of the Flow SDK.
integration contains the following properties:
| Property | Type | Description |
|---|---|---|
|
| The unique identifier of the browser session that created the |
|
| The unique identifier of the payment session response. |
|
| The name of the payment method used for the payment, if applicable. |
Request errors are caused by network request failures.
request contains the following properties:
| Property | Type | Description |
|---|---|---|
|
| The unique identifier of the browser session that created the |
|
| The unique identifier of the provided payment session response. |
|
| The name of the payment method used for the payment, if applicable. |
Payment method errors are caused by unexpected failures when integrating a payment method's client-side library.
paymentMethod contains the following properties:
| Property | Type | Description |
|---|---|---|
|
| The unique identifier of the browser session that created the |
|
| The unique identifier of the provided payment session response. |
|
| The name of the payment method used for the payment, if applicable. |
Submit errors are caused by invalid attempts to submit a payment request.
submit contains the following properties:
| Property | Type | Description |
|---|---|---|
|
| The unique identifier of the browser session that created the |
|
| The unique identifier of the provided payment session response. |
|
| The name of the payment method used for the payment, if applicable. |
Validation errors are caused by an invalid value in the UpdateDetails passed to the CheckoutComponents.update() method.
| Property | Type | Description |
|---|---|---|
|
| The unique identifier of the browser session that created the |
|
| The unique identifier of the provided payment session response. |
|
| The name of the payment method used for the payment, if applicable. |