- A Web Drop-in\/Components or API-only integration that uses the Advanced flow<\/a> integration <\/li>
- A Web Drop-in\/Components integration that uses the Sessions flow<\/a> <\/li>
- A Hosted Checkout<\/a> integration <\/li><\/ul><\/td>\n<\/tr>\n
\n API credential roles<\/a><\/strong><\/td>\n Make sure that your API credential has the Checkout webservice role<\/strong>.<\/td>\n<\/tr>\n \n Webhooks<\/a><\/strong><\/td>\n Subscribe to Standard webhooks.<\/td>\n<\/tr>\n \n Limitations<\/strong><\/td>\n - We only recommend to use this solution if you are based in the United States (US), or if you are based in another country\/region, but accept payments in the US App Store for digital goods and services. For other types of purchases, use our native iOS Drop-in\/Components solution with the Sessions<\/a> or Advanced<\/a> flow. <\/li>
- If you redirect your shoppers to a website to accept subscription payments, you need to manage subscriptions yourself. See our Tokenization<\/a> documentation to learn more about subscription payments. <\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
How it works<\/h2>\n
- \n
- You offer in-app purchases in your native iOS app.<\/li>\n
- The shopper selects the option to make a purchase, for example by selecting a button in your app.<\/li>\n
- You redirect the shopper to a website where they can complete the payment.<\/li>\n
- The shopper completes their payment on the website.<\/li>\n
- You redirect the shopper back to your app, and show them a purchase confirmation.<\/li>\n<\/ol>\n
To let your shoppers pay on a website, you can use a Web integration, or our Hosted Checkout solution.<\/p>\n
\n\n
![\"\"](\"\/user\/pages\/docs\/02.online-payments\/45.out-of-app-payments-on-ios\/how_it_works_iOS.png\")
\n<\/a><\/p>\n<\/div>\nRedirect your shoppers for an out-of-app payment<\/h2>\n
We offer two solutions to redirect your shoppers to an external website in a mobile browser from your iOS app to complete their payment:<\/p>\n
- \n
- Web Drop-in\/Components<\/strong>: redirect your shoppers to your existing web checkout page in the mobile browser. This option requires you to build your own Web integration with Adyen, and implement your own logic to return the shopper back to your app.<\/li>\n
- Hosted Checkout<\/strong>: redirect the shopper to an Adyen-hosted website where they make the payment. This option requires lower development effort, and the shopper is automatically redirected back to your app after they complete the payment.<\/li>\n<\/ul>\n
Refer to our comparison of Hosted Checkout and Web integrations<\/a> to learn more about the differences between the solutions.<\/p>\n\n
\n\nTest and go live<\/h2>\n
Before going live with your integration, use our test card numbers<\/a> to test that you make a successful out-of-app payment.<\/p>\n
See also<\/h2>\n
- \n
- Build your integration<\/a><\/li>\n
- Result codes<\/a><\/li>\n
- Go-live checklist<\/a><\/li>\n<\/ul>","url":"https:\/\/docs.adyen.com\/online-payments\/out-of-app-payments-on-ios","articleFields":{"description":"Redirect your users to a website to complete payments for their in-app purchases.","feedback_component":true,"last_edit_on":"21-06-2023 22:37","filters_component":false,"page_id":"636b0f7b-771d-4d42-94fe-33a78d3b690b","decision_tree":"[]"},"algolia":{"url":"https:\/\/docs.adyen.com\/online-payments\/out-of-app-payments-on-ios","title":"Out-of-app payments on iOS","content":"Apple's updated App Review Guidelines allow linking to an external website from your app to let your users complete their payments for in-app purchases. This enables you to have more control over your payment flows.\nRequirements\nBefore you begin, take into account the following requirements, limitations, and preparations.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nTo redirect shoppers from your app to the browser to complete payments, you need one of the following setups: A Web Drop-in\/Components or API-only integration that uses the Advanced flow integration A Web Drop-in\/Components integration that uses the Sessions flow A Hosted Checkout integration \n\n\nAPI credential roles\nMake sure that your API credential has the Checkout webservice role.\n\n\nWebhooks\nSubscribe to Standard webhooks.\n\n\nLimitations\nWe only recommend to use this solution if you are based in the United States (US), or if you are based in another country\/region, but accept payments in the US App Store for digital goods and services. For other types of purchases, use our native iOS Drop-in\/Components solution with the Sessions or Advanced flow. If you redirect your shoppers to a website to accept subscription payments, you need to manage subscriptions yourself. See our Tokenization documentation to learn more about subscription payments. \n\n\n\nHow it works\n\nYou offer in-app purchases in your native iOS app.\nThe shopper selects the option to make a purchase, for example by selecting a button in your app.\nYou redirect the shopper to a website where they can complete the payment.\nThe shopper completes their payment on the website.\nYou redirect the shopper back to your app, and show them a purchase confirmation.\n\nTo let your shoppers pay on a website, you can use a Web integration, or our Hosted Checkout solution.\n\n\n \n\n\nRedirect your shoppers for an out-of-app payment\nWe offer two solutions to redirect your shoppers to an external website in a mobile browser from your iOS app to complete their payment:\n\nWeb Drop-in\/Components: redirect your shoppers to your existing web checkout page in the mobile browser. This option requires you to build your own Web integration with Adyen, and implement your own logic to return the shopper back to your app.\nHosted Checkout: redirect the shopper to an Adyen-hosted website where they make the payment. This option requires lower development effort, and the shopper is automatically redirected back to your app after they complete the payment.\n\nRefer to our comparison of Hosted Checkout and Web integrations to learn more about the differences between the solutions.\n\n\n \n \n \n \n\n\nTest and go live\nBefore going live with your integration, use our test card numbers to test that you make a successful out-of-app payment.\nSee also\n\nBuild your integration\nResult codes\nGo-live checklist\n","type":"page","locale":"en","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Online payments","lvl2":"Out-of-app payments on iOS"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/online-payments","lvl2":"\/online-payments\/out-of-app-payments-on-ios"},"levels":3,"category":"Online Payments","category_color":"green","tags":["Out-of-app","payments"]},"articleFiles":{"how_it_works_iOS.png":"
![\"\"](\"https:\/\/docs.adyen.com\/user\/pages\/docs\/02.online-payments\/45.out-of-app-payments-on-ios\/how_it_works_iOS.png\")
"}}
- Result codes<\/a><\/li>\n
- Hosted Checkout<\/strong>: redirect the shopper to an Adyen-hosted website where they make the payment. This option requires lower development effort, and the shopper is automatically redirected back to your app after they complete the payment.<\/li>\n<\/ul>\n
- Web Drop-in\/Components<\/strong>: redirect your shoppers to your existing web checkout page in the mobile browser. This option requires you to build your own Web integration with Adyen, and implement your own logic to return the shopper back to your app.<\/li>\n
- If you redirect your shoppers to a website to accept subscription payments, you need to manage subscriptions yourself. See our Tokenization<\/a> documentation to learn more about subscription payments. <\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
- A Web Drop-in\/Components integration that uses the Sessions flow<\/a> <\/li>