Contenu
Configuration de l'environnement
Vous devez avoir créer un compte de test commerçant en demandant à notre équipe support@payline.com
Créer votre clé d'accès pour réaliser vos appels API.
Pour plus d'informations sur ces étapes : Comment démarrer
Vérifier les versions de iOS et Android.
Créer un template sur le Centre d'administration Payline.
Posséder une application mobile commerçant intégrant le SDK avec les fonctions showPaymentForm
et finalStateHasBeenReached.
Le SI du marchand gère le doWebPayment et le getWebPaymentDetails.
Configurer le SDK Payline sur l'environnement sélectionné (Test/Production).
Les guides d'installation Android et iOS
Les deux guides d'installation vous permettront d'installer le SDK Payline :
Veillez à utiliser la dernière version du SDK Payline pour inclure toutes les dernières mises à jour concernant les évolutions et les correctifs. Les versions précédentes ne sont pas maintenues.
Initialisation
Pour l'initialisation du SDK, il faut tout d'abord instancier un PaymentController()
et un WalletController()
ainsi que leurs delegates associés.
Réaliser un paiement
Le SDK appelle la méthode showPaymentForm
pour afficher la page des moyens de paiement.
Le SI Marchand récupère la demande d'affichage et appelle Payline avec le web service doWebPayment.
Le SDK appelle la demande de résultat et le SI Marchand appelle le getWebPaymentDetails.
Le commerçant récupérer le résultat avec le finalStateHasBeenReached.
Accéder au portefeuille
La méthode showManageWallet
est utilisée pour afficher la page du portefeuille.
Comme pour la réalisation d'un paiement, la récupération du paramètre url
se fera selon vos choix d'implementation.
Paiement à redirection (3DSecure, Paypal)
Le SDK intercepte l'événement javascript "didShowState". Si le code retour est "PAYMENT_REDIRECT_NO_RESPONSE" alors le SDK passe la WebView en mode "full screen". Une solution devra être proposée pour donner la possibilité d'un retour arrière.
Pour les autres cas, il redimensionne la WebView dans sa dimension standard.
Design du formulaire inclus dans la webview
La page HTML est hébergée sur les serveurs Payline (cf. intégration en mode template hébergé). Dans cette solution le commerçant devra ajouter le javascript nécessaire pour le dialogue avec le SDK natif. De plus, le SDK aura besoin de connaitre l'URL complète de redirection (à la place du token).
- data-template = column
- data-auto_init = true
- data-embeddedredirectionallowed = false
- data-partnerreturnurl = null
Fonction Javascript
- updateWebpaymentData()
- isSandBox()
- endToken()
- getLanguage()
- getContextInfo(key)
- finalizeShortCut()
- getBuyerShortCut()
Callback Javascript
- data-event-didshowstate
- data-event-finalstatehasbeenreached
Versions OS supportées
- Android 5 et ultérieure
- iOS 9 et ultérieure
Langage de développement
- Android : Java
- iOS : Swift