{"title":"Benefit Redirect Component","category":"default","creationDate":1776961628,"content":"<p>This page explains how to add Benefit to your existing iOS Components integration.<\/p>\n<h2>Requirements<\/h2>\n<p>Select the <a href=\"\/pt\/online-payments\/build-your-integration\">server-side flow<\/a> that your integration uses:<\/p>\n\n<div id=\"tabTqOI0\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Sessions flow&quot;,&quot;content&quot;:&quot;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Requirement&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;strong&gt;Integration type&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Make sure that you have built a Sessions flow &lt;a href=\\&quot;\\\/pt\\\/online-payments\\\/build-your-integration\\\/sessions-flow?platform=iOS&amp;amp;integration=Components\\&quot;&gt;iOS Components integration&lt;\\\/a&gt;. &lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;strong&gt;Setup steps&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Before you begin, &lt;a href=\\&quot;\\\/pt\\\/payment-methods\\\/add-payment-methods\\&quot;&gt;add Benefit in your Customer Area&lt;\\\/a&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&quot;,&quot;altTitle&quot;:&quot;sessions&quot;,&quot;oldTabId&quot;:&quot;sessions-requirements_1&quot;,&quot;relation&quot;:&quot;sessions&quot;},{&quot;title&quot;:&quot;Advanced flow&quot;,&quot;content&quot;:&quot;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Requirement&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;strong&gt;Integration type&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Make sure that you have built an Advanced flow &lt;a href=\\&quot;\\\/pt\\\/online-payments\\\/build-your-integration\\\/advanced-flow?platform=iOS&amp;amp;integration=Components\\&quot;&gt;iOS Components integration&lt;\\\/a&gt;. &lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;strong&gt;Setup steps&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Before you begin, &lt;a href=\\&quot;\\\/pt\\\/payment-methods\\\/add-payment-methods\\&quot;&gt;add Benefit in your Customer Area&lt;\\\/a&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&quot;,&quot;altTitle&quot;:&quot;advanced&quot;,&quot;oldTabId&quot;:&quot;advanced-requirements_2&quot;,&quot;relation&quot;:&quot;advanced&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2>API reference<\/h2>\n<p>You do not need to send additional fields for Benefit. To see optional fields that you can send for all payment methods, choose the endpoint you integrated:<\/p>\n<ul>\n<li> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/sessions\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/sessions<\/a>&#58; This is the default with <a href=\"\/pt\/online-payments\/build-your-integration\/sessions-flow?platform=iOS&amp;integration=Components\">Components v5.0.0<\/a> or later.<\/li>\n<li> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments<\/a>&#58; If you implemented an <a href=\"\/pt\/online-payments\/build-your-integration\">additional use case<\/a>.<\/li>\n<\/ul>\n<h2>Component configuration<\/h2>\n<h3>v5.0.0 or later<\/h3>\n<p>If your integration uses iOS Components v5.0.0 or later, configure and create an instance of the Benefit Component:<\/p>\n\n<div id=\"tabMBlu5\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;\\\/sessions&quot;,&quot;content&quot;:&quot;\\n  &lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Component configuration&#039;\\&quot; :id=\\&quot;&#039;instant_component_sessions&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;swift\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;let paymentMethods = session.sessionContext.paymentMethods\\\\n\\\\\\\/\\\\\\\/ Check that the payment method is supported before showing the Component.\\\\nguard let paymentMethod = paymentMethods.paymentMethod(ofType: .other(\\\\\\&quot;benefit\\\\\\&quot;)) else { return }\\\\nlet component = InstantPaymentComponent(paymentMethod: paymentMethod,\\\\n                                        context: context,\\\\n                                        order: nil)\\\\nself.currentComponent = component\\\\n\\\\\\\/\\\\\\\/ Set the session as the delegate.\\\\ncomponent.delegate = session\\\\ncomponent.initiatePayment()\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n    &quot;,&quot;altTitle&quot;:&quot;sessions-5-config&quot;,&quot;oldTabId&quot;:&quot;sessions-5-config_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Advanced flow&quot;,&quot;content&quot;:&quot;\\n  &lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Component configuration&#039;\\&quot; :id=\\&quot;&#039;instant_component_advanced&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;swift\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;\\\\\\\/\\\\\\\/ Check that the payment method is supported before showing the Component.\\\\nguard let paymentMethod = paymentMethods.paymentMethod(ofType: .other(\\\\\\&quot;benefit\\\\\\&quot;)) else { return }\\\\nlet component = InstantPaymentComponent(paymentMethod: paymentMethod,\\\\n                                        context: context,\\\\n                                        order: nil)\\\\nself.currentComponent = component\\\\n\\\\\\\/\\\\\\\/ Set the component as the delegate.\\\\ncomponent.delegate = self\\\\ncomponent.initiatePayment()\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n    &quot;,&quot;altTitle&quot;:&quot;advanced-5-config&quot;,&quot;oldTabId&quot;:&quot;advanced-5-config_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h3>v4.x.x<\/h3>\n<p>If your integration uses an earlier version of iOS Components:<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Component configuration'\" :id=\"''\" :code-data='[{\"language\":\"swift\",\"tabTitle\":\"\",\"content\":\"\\\/\\\/ Check that the payment method is supported before showing the Component.\\nguard let paymentMethod = paymentMethods.paymentMethod(ofType: BenefitPaymentMethod.self) else { return }\\nlet style = FormComponentStyle()\\nlet component = BenefitComponent(paymentMethod: paymentMethod,\\n                                apiContext: context,\\n                                style: style)\\npresent(component)\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>There are no configuration steps specific to Benefit required for Components.<\/p>\n<h2 id=\"test-and-go-live\">Test and go live<\/h2>\n<p>To test Benefit payments, use the <a href=\"https:\/\/tappayments.api-docs.io\/2.0\/testing\/test-card-numbers\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">test card details provided by Tap<\/a>.<\/p>\n<p>Before you can accept live Benefit  payments, you need to submit a request for Benefit  in your <a href=\"https:\/\/ca-live.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">live Customer Area<\/a>.<\/p>\n<h2 id=\"see-also\">See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/online-payments\/build-your-integration\/sessions-flow?platform=iOS&amp;integration=Components\"\n                        target=\"_self\"\n                        >\n                    iOS Components integration guide\n                <\/a><\/li><li><a href=\"\/development-resources\/webhooks\"\n                        target=\"_self\"\n                        >\n                    Webhooks\n                <\/a><\/li><li><a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/CheckoutService\/latest\/overview\"\n                        target=\"_blank\"\n                         class=\"external\">\n                    API Explorer\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/payment-methods\/benefit\/ios-component","articleFields":{"description":"Add Benefit to your existing iOS Components integration.","parameters":{"payment_method":"Benefit","country_code":"BH","currency_code":"BHD","payment_method_type":"benefit","return_url":"my-app:\/\/adyen","integration":"Components","platform":"iOS","integration_guide_url":"build-your-integration\/sessions-flow?platform=iOS&integration=Components","component_name":"the Benefit Component","component_js_const":"benefit","ios_config_component_type":"InstantPaymentComponent","ios_config_payment_method":"Benefit","ios_config_component_name":"Benefit"},"feedback_component":true},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/payment-methods\/benefit\/ios-component","title":"Benefit Redirect Component","content":"This page explains how to add Benefit to your existing iOS Components integration.\nRequirements\nSelect the server-side flow that your integration uses:\n\n\n    \n        \n        \n    \n\n\nAPI reference\nYou do not need to send additional fields for Benefit. To see optional fields that you can send for all payment methods, choose the endpoint you integrated:\n\n \/sessions&#58; This is the default with Components v5.0.0 or later.\n \/payments&#58; If you implemented an additional use case.\n\nComponent configuration\nv5.0.0 or later\nIf your integration uses iOS Components v5.0.0 or later, configure and create an instance of the Benefit Component:\n\n\n    \n        \n        \n    \n\n\nv4.x.x\nIf your integration uses an earlier version of iOS Components:\n\n    \n\nThere are no configuration steps specific to Benefit required for Components.\nTest and go live\nTo test Benefit payments, use the test card details provided by Tap.\nBefore you can accept live Benefit  payments, you need to submit a request for Benefit  in your live Customer Area.\nSee also\n\n\n                    iOS Components integration guide\n                \n                    Webhooks\n                \n                    API Explorer\n                \n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Payment methods","lvl2":"Benefit","lvl3":"Benefit Redirect Component"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/payment-methods","lvl2":"https:\/\/docs.adyen.com\/pt\/payment-methods\/benefit","lvl3":"\/pt\/payment-methods\/benefit\/ios-component"},"levels":4,"category":"Payment method","category_color":"green","tags":["Benefit","Redirect","Component"]}}