Integration
In addition to our general best practice guidance, we recommend you add support for a return URL to handle in-app browsers, detailed below.Set a return URL to handle in-app browsers
To prevent the possibility for some customers using in-app browsers to be left without a direct link back to your site, we recommend setting the optionalfullPageReturnUrl
. When the fullPageReturnUrl
is set as well as redirectMode=fallback
then Embed will first attempt its normal redirect behavior and only if Embed detects a situation where the normal redirect cannot occur (for example when your customer is accessing your application from one of these in-app browsers) it will redirect the customer to your fullPageReturnUrl
, appending it with the transaction ID and transaction status.
fullPageReturnUrl
that handles the resulting customer redirection for those edge cases.
If preferable, you can set the redirectMode
to fullPage
to always redirect to the fullPageReturnUrl
. This can be very useful when testing your return URL integration.
Here is an example of how these properties can be set when configuring Embed.