Barion Smart Gateway for mobile: Difference between revisions

From Barion Documentation
Jump to navigation Jump to search
No edit summary
No edit summary
 
(8 intermediate revisions by 2 users not shown)
Line 2: Line 2:
Barion simplifies the process of payments through the [[Getting started|Barion Smart Gateway]], enabling users to make secure transactions using their Barion balance or credit card directly from within mobile applications. Before you start to integrate we recommend [[Sandbox|reading this article]] first.
Barion simplifies the process of payments through the [[Getting started|Barion Smart Gateway]], enabling users to make secure transactions using their Barion balance or credit card directly from within mobile applications. Before you start to integrate we recommend [[Sandbox|reading this article]] first.


To ensure a smooth integration experience, please review the following guidelines:
When you integrate Barion Smart Gateway into your mobile application, you have multiple technology options, but some of them do not support every payment method of the gateway.


=== Payment Initiation ===
To ensure the full capability of the Barion Smart Gateway, please review the following guidelines:
When an application initiates a payment, it should be presented to users as a responsive website, mirroring the web payment experience. However, specific technologies must be employed to unlock the full functionality of the Barion Smart Gateway.


=== User Authentication ===
For an optimal phone experience, we recommend hiding the 'back arrow' navigation button on our interface. To achieve this, append the following parameter to the <code>GatewayUrl</code> query string: <code>backNavigationVisible=false</code>. This setting disables the button across all screen sizes, so use it only if you are certain the buyer will view the payment gateway in a browser launched from your application.
For user authentication within the Barion Smart Gateway, a passkey is required. To seamlessly display the Barion Smart Gateway within your application, consider the following platform-specific instructions:
== Android ==
{{NotificationBox|title=Action required for Android apps|text=If your application currently relies on WebView for the Barion Smart Gateway integration, please update your app to use "CustomTabsIntent".|color=#1993C7}}
To provide a consistent and secure user experience, you must utilize a first-party solution called "CustomTabsIntent" for displaying the Barion Smart Gateway on Android. WebView unfortunately does not support Google Pay or Barion Wallet payment methods.
 
To assist you in the development process, [https://developer.chrome.com/docs/android/custom-tabs/guide-get-started/ Google provides a comprehensive step-by-step guide for integrating CustomTabsIntent seamlessly].
{{NotificationBox|title=IMPORTANT|text=If you do not implement CustomTabsIntent, your users will not be able to pay with Google Pay and Barion Wallet from the application.|color=#FF7A3D}}


== Android ==
To provide a consistent and secure user experience, you must utilize a first-party solution called "CustomTabsIntent" for displaying the Barion Smart Gateway on Android. It's essential to note that WebView does not support Passkey authentication.


Action Required for Android Apps: If your application currently employs WebView to display the Barion Smart Gateway, it is imperative to prioritize refactoring.
== iOS/iPadOS ==
{{NotificationBox|title=Action required for iOS apps|text=If your application currently relies on WKWebView or UIWebView for the Barion Smart Gateway integration, please update you app to SFSafariViewController.|color=#1993C7}}
On iOS and iPadOS, you must utilize a first-party solution called "SFSafariViewController" for displaying the Barion Smart Gateway on iOS. It's essential to note that WKWebView and UIWebView do not support the full functionality of the Barion Smart Gateway.


To assist you in the development process, [https://developer.apple.com/documentation/safariservices/sfsafariviewcontroller Apple provides a comprehensive step-by-step guide for integrating SFSafariViewController seamlessly].
{{NotificationBox|title=IMPORTANT|text=Failure to implement SFSafariViewController will result in users being unable to log in to their Barion Wallet from the application.|color=#FF7A3D}}


[https://developer.chrome.com/docs/android/custom-tabs/guide-get-started/ Google's step-by-step guide] will help you using CustomTabsIntent.{{NotificationBox|title=Action Required for Android Apps|text=If your application currently employs WebView to display the Barion Smart Gateway, it is imperative to prioritize refactoring.|color=#1993C7}}{{NotificationBox|title=IMPORTANT|text=Failure to implement CustomTabsIntent will result in users being unable to log in to their Barion Wallet.|color=#FF7A3D}}


=== iOS ===
By adhering to these guidelines and implementing the recommended solutions, you can ensure that your mobile application seamlessly leverages the power of the Barion Smart Gateway, enhancing user convenience and security in payment transactions.

Latest revision as of 12:20, 15 October 2024

Barion Smart Gateway integration for mobile applications

Barion simplifies the process of payments through the Barion Smart Gateway, enabling users to make secure transactions using their Barion balance or credit card directly from within mobile applications. Before you start to integrate we recommend reading this article first.

When you integrate Barion Smart Gateway into your mobile application, you have multiple technology options, but some of them do not support every payment method of the gateway.

To ensure the full capability of the Barion Smart Gateway, please review the following guidelines:

For an optimal phone experience, we recommend hiding the 'back arrow' navigation button on our interface. To achieve this, append the following parameter to the GatewayUrl query string: backNavigationVisible=false. This setting disables the button across all screen sizes, so use it only if you are certain the buyer will view the payment gateway in a browser launched from your application.

Android

Action required for Android apps
If your application currently relies on WebView for the Barion Smart Gateway integration, please update your app to use "CustomTabsIntent".

To provide a consistent and secure user experience, you must utilize a first-party solution called "CustomTabsIntent" for displaying the Barion Smart Gateway on Android. WebView unfortunately does not support Google Pay or Barion Wallet payment methods.

To assist you in the development process, Google provides a comprehensive step-by-step guide for integrating CustomTabsIntent seamlessly.

IMPORTANT
If you do not implement CustomTabsIntent, your users will not be able to pay with Google Pay and Barion Wallet from the application.


iOS/iPadOS

Action required for iOS apps
If your application currently relies on WKWebView or UIWebView for the Barion Smart Gateway integration, please update you app to SFSafariViewController.

On iOS and iPadOS, you must utilize a first-party solution called "SFSafariViewController" for displaying the Barion Smart Gateway on iOS. It's essential to note that WKWebView and UIWebView do not support the full functionality of the Barion Smart Gateway.

To assist you in the development process, Apple provides a comprehensive step-by-step guide for integrating SFSafariViewController seamlessly.

IMPORTANT
Failure to implement SFSafariViewController will result in users being unable to log in to their Barion Wallet from the application.


By adhering to these guidelines and implementing the recommended solutions, you can ensure that your mobile application seamlessly leverages the power of the Barion Smart Gateway, enhancing user convenience and security in payment transactions.