Aller au contenu

SDK mobiles

Les SDK Android et iOS de Futa ouvrent le paiement hébergé en plein écran dans la vue web de la plateforme, à l’intérieur de votre application, pour un paiement que votre serveur a créé avec { "mode": "app" }, en lui passant son checkout_url. Ils ne sont pas encore distribués : pour des essais en bac à sable, les personnes à qui Futa a ouvert Futa-payer-web les construisent depuis leurs sources, sdks/android et sdks/ios.

Sur Android (Android 8.0 et plus), FutaCheckout.open prend l’activité et CheckoutOptions : checkoutOrigin, checkoutUrl, returnUrl facultative, onState et onClose. Sur iOS (iOS 16 et plus), FutaCheckout.open prend le contrôleur qui présente et CheckoutOptions : checkoutOrigin, checkoutURL, returnURL, onState, onClose et openOutside. Avec le bac à sable hébergé, checkoutOrigin est https://checkout.sandbox.futa-app.com, qu’un émulateur comme un appareil atteignent ; sur votre machine, c’est http://10.0.2.2:18140 depuis l’émulateur Android, en HTTP simple dans une application de débogage, ou http://127.0.0.1:18140 depuis le simulateur iOS.

onState est indicatif : confirmez le paiement sur votre serveur, par le webhook signé ou GET /v1/payments/{id}. onClose donne final et la raison : closed, returned ou left. Seule l’origine du paiement hébergé se charge dans la vue web ; toute autre adresse, la remise à la banque comprise, s’ouvre hors de l’application et termine la session, et un reçu s’ouvre dehors sans la terminer.

Votre application possède la vue web : elle peut lire ce que le payeur y saisit, son numéro compris. Traitez ces saisies comme celles de vos propres formulaires, et ne les enregistrez jamais.