Aller au contenu principal
Sur cette page

Les SDK DEUNA intègrent les expériences de paiement dans les applications web et mobiles. Choisissez le guide de la plateforme correspondant à l'application que vous déployez, puis utilisez la méthode de produit prise en charge par ce SDK.

Choisir une plateforme et un flux#

CapacitéSite WebAndroidiOSRéagir à l'initié
Widget de paiementinitPaymentWidgetinitPaymentWidgetinitPaymentWidgetinitPaymentWidget
Finaliser la commandeNon exposéinitCheckoutinitCheckoutNon exposé
Coffre-fort de paiement et Paiement en un clicinitElementsinitElementsinitElementsinitElements
Continuer l'action 3DS ou une autre action en attenteinitNextActioninitNextActioninitNextActioninitNextAction
Expérience avec des bons de réductioninitVoucherWidgetinitVoucherWidgetinitVoucherinitVoucherWidget
Interface de portefeuille natifApple Pay et Google PayGoogle PayerApple PayerApple Pay et Google Pay
Présentation modale et intégréeOuiOuiOuiOui

Flux d'intégration#

Diagramme de séquence
1Web or mobile app2Merchant backend3DEUNARequest a checkout sessionCreate order with private API keyReturn order tokenReturn order token onlyInitialize SDK with public API keyOpen the selected experienceSuccess, error, close, and lifecyclecallbacksSigned webhook with final state
Marchand ou clientDEUNA
  1. Créez la commande sur votre moteur de recherche avec un privé Clé API.
  2. Retournez uniquement le jeton de commande temporaire à l'application.
  3. Initialisez le SDK avec la clé API publique et l'environnement correspondants.
  4. Ouvrez l'expérience appropriée et gérez les appels de retour, les erreurs, la fermeture et les événements de cycle de vie.
  5. Utilisez l'appel de retour pour mettre à jour l'interface, mais utilisez un webhook vérifié comme source de vérité pour la finalisation.

Règles de cycle de vie courants#

  • Assurez-vous qu'une seule instance de l'SDK reste active pendant toute la durée de l'expérience.
  • Considérez onSuccess comme un signal de l'interface utilisateur ; vérifiez l'état de paiement final sur votre backend.
  • Poignée onError et onClosed distinctement. La fermeture d'un widget par un utilisateur ne signifie pas nécessairement un échec de paiement.
  • Libérer le widget lorsque l'écran ou le flux parent se termine. Utilisez close() Pour un flux actif et le mécanisme de désactivation spécifique à la plateforme pour une vue intégrée.
  • Appeler initNextAction Uniquement avec le jeton de commande pour une commande que DEUNA signale comme nécessitant une action supplémentaire.
  • Vérifiez la disponibilité du portefeuille natif avant d'afficher un bouton Apple Pay ou Google Pay appartenant au commerçant.

Code officiel#

Les dépôts maintenus sont la source d'information officielle concernant les versions des paquets, les versions des plateformes prises en charge, les notes de version et les exemples exécutables.