{"title":"Upgrade to Adyen iOS v5","category":"default","creationDate":1776961627,"content":"

If your integration uses iOS v4.10.1 or before and you are upgrading it to use v5.0.0, make the following changes to your integration.<\/p>\n

Checkout API version<\/h2>\n

We recommend using Checkout API v69<\/a>.<\/p>\n

Step 1: Upgrade methods<\/h2>\n

Change the methods in your integration from the ones in the v4.10.1 or earlier<\/strong> column to the ones in v5.0.0<\/strong> column:<\/p>\n\n\n\n\n\n\n\n\n\n
v4.10.1 or earlier<\/th>\nv5.0.0<\/th>\n<\/tr>\n<\/thead>\n
didFinalize(with success: Bool)<\/code><\/td>\ndidFinalize(with success: Bool, completion: (() -> Void)?)<\/code><\/td>\n<\/tr>\n
finalizeIfNeeded(with success: Bool, completion: (() -> Void)?)<\/code><\/td>\nfinalizeIfNeeded(with success: Bool, completion: (() -> Void)?)<\/code><\/td>\n<\/tr>\n
didOpenExternalApplication(_ component:<\/code><\/td>\ndidOpenExternalApplication(component:<\/code><\/td>\n<\/tr>\n
requestOrder(_ component: Component, completion: @escaping (Result<PartialPaymentOrder, Error>) -> Void)<\/code><\/td>\nrequestOrder(for component: Component, completion: @escaping (Result<PartialPaymentOrder, Error>) -> Void)<\/code><\/td>\n<\/tr>\n
cancelOrder(_ order: PartialPaymentOrder)<\/code><\/td>\ncancelOrder(_ order: PartialPaymentOrder, component: Component)<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Step 2: Upgrade initializing Drop-in and Components<\/h2>\n

When initializing Drop-in or a Component, you must now pass an instance of AdyenContext<\/a>. For example:<\/p>\n

\/\/ Create the APIContext with the client key and environment.\nlet apiContext = APIContext(clientKey: clientKey, environment: Environment.test)\n\n\/\/ Create the AdyenContext with the instance of APIContext and analytics configuration.\nlet adyenContext = AdyenContext(apiContext: apiContext, analyticsConfiguration: analyticsConfiguration)\n\n\/\/ Set the instance of AdyenContext in the Drop-in configuration.\nlet configuration = DropInComponent.Configuration(context: adyenContext)<\/code><\/pre>\n
Step 3: Update Components configuration<\/h2>\n
The configuration for a Component is now in a configuration object that corresponds to the Component<\/a> type. For example, to style the Redirect Component:<\/p>\n
\/\/ The configuration object for the Redirect Component.\nvar redirectComponentConfiguration = RedirectComponent.Configuration()\n\/\/ Configuration for the Redirect Component.\nredirectComponentConfiguration.style = \/\/Your styling.<\/code><\/pre>\n
Step 4: Update payment methods configuration<\/h2>\n
The configuration for a payment method is now in a configuration object that corresponds to the payment method component<\/a>. For example, to configure the Card Component:<\/p>\n
\/\/ The configuration object for the Card Component.\nvar cardComponentConfiguration = CardComponent.Configuration()\n\/\/ Configuration for the Card Component.\ncardComponentConfiguration.showsStorePaymentMethodField = true\ncardComponentConfiguration.localization = \/\/ Your localization configuration.<\/code><\/pre>\n
\n
In v5.9.0<\/a>, iDEAL uses InstantPaymentComponent<\/code>.<\/p>\n<\/div>\n
Apple Pay<\/h3>\n
For \n  ApplePayComponent.Configuration.init()<\/code>\n<\/a>, the only parameters you can pass are merchantIdentifier<\/code> and payment<\/code>. All other Apple Pay configuration properties are now mutable.<\/p>\n
Change the value of the payment<\/code> property from the one in the v4.10.1 or earlier<\/strong> column to the one in v5.0.0<\/strong> column::<\/p>\n\n\n\n\n\n
v4.10.1 or earlier<\/th>\nv5.0.0<\/th>\n<\/tr>\n<\/thead>\n
payment: Payment<\/code><\/td>\n\n  payment: ApplePayPayment<\/code>\n<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Cards<\/h3>\n
The value for each of the following properties is now a strongly typed array of values from the CardType<\/code> enum<\/a>:<\/p>\n