\n <\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/payment-methods\/mb-way\/ios-drop-in","articleFields":{"description":"Add MB Way to your Drop-in integration.","never_cache_twig":true,"parameters":{"tx_variant":"mbway","component_class_name":"MBWayComponent","pm_directory":"mb-way","ios_payment_method_class":"InstantPaymentMethod","camel_case":"mbWay","integration":"Drop-in","payment_method":"MB Way","action_type":"await"},"filters_component":true,"filters_config_folder":"payment-methods\/mb-way\/ios\/dropin"},"algolia":[{"url":"https:\/\/docs.adyen.com\/pt\/payment-methods\/mb-way\/ios-drop-in","title":"MB Way iOS Drop-in","content":"Requirements\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nMake sure that you have an existing Sessions flow Drop-in integration. Required version of Checkout API: v68 or later. \n\n\nSetup steps\nBefore you begin, add MB Way in your Customer Area.\n\n\n\nAdd additional parameters to your \/sessions request\nWhen you create a payment session, add the following parameters:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\n shopperStatement\n\nThe text to be shown on the shopper's bank statement.\n\n\n\n\n \n\n\n\n\nAdd additional configuration for MB Way\nYou do not need to add any configuration parameters for MB Way.\nTest and go live\nTo test your MB Way integration, you can use any telephone number; for example +351234567890.\nYou can check the status of MB Way test payments in your Customer Area > Transactions > Payments.\nBefore you can accept live MB Way payments, add MB Way in your live Customer Area.\nTrigger a resultCode\nTo trigger a specific resultCode value, append a code to the shopperStatement value in your \/payments request:\n\n\n\nresultCode\nCode to append to shopperStatement\n\n\n\n\nAuthorised(default test response)\n-c1\n\n\nPending\n-c3\n\n\nRefused\n-c5\n\n\n\nFor example, to receive resultCode: Refused, include the following in your \/payments request:\n\"shopperStatement\": \"MBWay shopper statement-c5\"","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Payment methods","lvl2":"MB Way","lvl3":"MB Way iOS Drop-in"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/payment-methods","lvl2":"https:\/\/docs.adyen.com\/pt\/payment-methods\/mb-way","lvl3":"\/pt\/payment-methods\/mb-way\/ios-drop-in"},"levels":4,"category":"Payment method","category_color":"green","tags":["Drop-in"]},{"url":"https:\/\/docs.adyen.com\/pt\/payment-methods\/mb-way\/ios-drop-in?flow=Sessions flow&integration=Drop-in","title":"Sessions flow Drop-in","content":"Requirements\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nMake sure that you have an existing Sessions flow Drop-in integration. Required version of Checkout API: v68 or later. \n\n\nSetup steps\nBefore you begin, add MB Way in your Customer Area.\n\n\n\nAdd additional parameters to your \/sessions request\nWhen you create a payment session, add the following parameters:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\n shopperStatement\n\nThe text to be shown on the shopper's bank statement.\n\n\n\n\n \n\n\n\n\nAdd additional configuration for MB Way\nYou do not need to add any configuration parameters for MB Way.\nTest and go live\nTo test your MB Way integration, you can use any telephone number; for example +351234567890.\nYou can check the status of MB Way test payments in your Customer Area > Transactions > Payments.\nBefore you can accept live MB Way payments, add MB Way in your live Customer Area.\nTrigger a resultCode\nTo trigger a specific resultCode value, append a code to the shopperStatement value in your \/payments request:\n\n\n\nresultCode\nCode to append to shopperStatement\n\n\n\n\nAuthorised(default test response)\n-c1\n\n\nPending\n-c3\n\n\nRefused\n-c5\n\n\n\nFor example, to receive resultCode: Refused, include the following in your \/payments request:\n\"shopperStatement\": \"MBWay shopper statement-c5\"","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Payment methods","lvl2":"MB Way","lvl3":"MB Way iOS Drop-in"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/payment-methods","lvl2":"https:\/\/docs.adyen.com\/pt\/payment-methods\/mb-way","lvl3":"\/pt\/payment-methods\/mb-way\/ios-drop-in"},"levels":4,"category":"Payment method","category_color":"green","tags":["Sessions flow","Drop-in"]},{"url":"https:\/\/docs.adyen.com\/pt\/payment-methods\/mb-way\/ios-drop-in?flow=Advanced flow&integration=Drop-in","title":"Advanced flow Drop-in","content":"Requirements\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nMake sure that you have an existing Advanced flow iOS Drop-in integration. \n\n\n\nAction handling\nMake sure that your existing integration is set up to handle the additional action. action.type: await.\n\n\n\nSetup steps\nBefore you begin, add MB Way in your Customer Area.\n\n\n\nAdd additional configuration for MB Way\nYou do not need to add any configuration parameters for MB Way.\nAdd additional parameters to your \/payments request\nWhen you make a payment, add the following parameters:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\n paymentMethod.type\n\nSet this value to mbway.\n\n\n paymentMethod.telephoneNumber\n\nThe shopper's mobile phone number.\n\n\n shopperStatement\n\nThe text to be shown on the shopper's bank statement.\n\n\n\n\n \n\n\n\n\nThe \/payments response contains:\n\nresultCode: Pending (The shopper must complete the payment in their MB Way app.)\naction: Use this object to display the waiting screen while the shopper completes the payment in their MB Way app.\n\n\n \n\nEnable App2App switch\nTo provide a seamless experience for shoppers on mobile devices, you can implement the App2App flow. This removes the need for the shopper to manually enter their phone number and deep links them directly to the MB WAY app.\nStep 1: Send a payment request\nWhen making a \/payments request, include:\n\nchannel - the shopper's platform, either iOS or Android. If the channel parameter is missing or set to Web, the standard flow (requiring a phone number) will apply.\nreturnUrl - the URL to where the shopper will be redirected after authorizing the payment in the MB WAY app.\n\n\n \n\nStep 2: Handle the response\nIf the request is successful, you will receive an action object in the response.\n\nThe action.url will contain the MB WAY deep link (mbway:\/\/...).\nThe returnUrl you provided in the request is automatically appended to this deep link.\n\n\n \n\nStep 3: Redirect the shopper\nUse the URL provided in the action object to redirect the shopper.\n\nDo not wrap this link in an intermediate page (a so-called glue page). The deep link is designed to switch the user directly to the MB WAY app to ensure the smoothest experience.\nWhen the user authorizes the transaction in the MB WAY app, they are automatically redirected back to your application via the returnUrl.\nTest and go live\nTo test your MB Way integration, you can use any telephone number; for example +351234567890.\nYou can check the status of MB Way test payments in your Customer Area > Transactions > Payments.\nBefore you can accept live MB Way payments, add MB Way in your live Customer Area.\nTrigger a resultCode\nTo trigger a specific resultCode value, append a code to the shopperStatement value in your \/payments request:\n\n\n\nresultCode\nCode to append to shopperStatement\n\n\n\n\nAuthorised(default test response)\n-c1\n\n\nPending\n-c3\n\n\nRefused\n-c5\n\n\n\nFor example, to receive resultCode: Refused, include the following in your \/payments request:\n\"shopperStatement\": \"MBWay shopper statement-c5\"","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Payment methods","lvl2":"MB Way","lvl3":"MB Way iOS Drop-in"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/payment-methods","lvl2":"https:\/\/docs.adyen.com\/pt\/payment-methods\/mb-way","lvl3":"\/pt\/payment-methods\/mb-way\/ios-drop-in"},"levels":4,"category":"Payment method","category_color":"green","tags":["Advanced flow","Drop-in"]}],"articleFiles":{"payments-response.json":"
payments-response.json<\/p>"}}