Aller au contenu principal
Sur cette page

L'SDK DEUNA Web actuel ne permet pas d'accéder à initCheckout. Créez la page de finalisation de commande de votre entreprise et intégrez initPaymentWidget pour le paiement, ou utilisez le SDK natif maintenu lorsque la finalisation de la commande se fait dans une application mobile.

Sélectionnez l'intégration prise en charge#

Diagramme de flux
1Where does checkoutrun?2-- Mobile app3-- DEUNAconfiguration4Merchant page +Payment Widget5Confirm availablehosted experiencewith DEUNA6iOS, Android, orReact Native SDK7Backend creates andverifies order
Marchand ou clientDEUNA
NécessaireSurface prise en charge
Ajouter des méthodes de paiement à un processus de commande en ligne existantWidget de paiement pour le Web
Stocker une carte ou utiliser Click to PayÉléments et stockage de cartes
Continuer une transaction 3DS ou une action APMProchaine étape
Créer un processus de commande mobile natifiOS, Android, ou Réagir à l'initié
Intégrer un processus de commande web existantSDK web dans un WebView mobile, avec les limitations documentées

Architecture web recommandée#

01 · merchant UI
Collecter les données de commande
Utilisez vos propres champs de panier, de contact, d'expédition et de consentement dans votre application.
02 · merchant backend
Créer la commande
Valider les totaux et envoyer le contrat de commande pris en charge.
03 · DEUNA widget
Collecter le paiement
Ouvrir le widget de paiement avec le jeton de commande retourné.
04 · merchant backend
Vérifier et finaliser
Utiliser l'état de commande final DEUNA et les webhooks.
JavaScript
const {orderToken, merchantOrderId} = await createOrderFromServer(checkoutState);

await DeunaSDK.initPaymentWidget({
  orderToken,
  mode: 'target',
  target: '#payment-step',
  callbacks: {
    onSuccess: () => renderVerifiedResult(merchantOrderId),
    onError: showPaymentRecovery,
    onClosed: () => returnToPaymentMethods(),
    onResize: ({height}) => resizePaymentStep(height),
  },
});

Migration depuis initCheckout#

  1. Conserver l'état du panier, de la livraison, du paiement, du client et du consentement dans l'application du commerçant.
  2. Déplacer la création de commande vers le backend du commerçant si elle a été effectuée côté client.
  3. Remplacer initCheckout(...) et initPaymentWidget({orderToken, ...}).
  4. Mapper la gestion précédente de la finalisation de la commande à onSuccess, puis récupérer la commande sur le backend.
  5. Mapper l'ancienne analyse de cycle de vie à la nouvelle Événements SDK.
  6. Tester les largeurs mobiles, l'édition des adresses, la navigation dans le navigateur, 3DS, les redirections APM et la récupération après rafraîchissement.

Propriété de l'état#

ÉtatPropriétaire
Contenu du panier, prix, inventaire, livraison, taxesBackend du commerçant
Formulaire de paiement et navigation par étapesApplication du commerçant
Méthodes de paiement et saisie de données compatiblesWidget de paiement DEUNA et connexions configurées
Traitement du paiement et état de commande normaliséDEUNA API
Décision de livraisonBackend du commerçant après vérification

Disposition responsive#

Placer l'élément de paiement dans un flux d'une colonne sur les petits écrans. Éviter l'affichage de la synthèse de commande et du contenu de paiement côte à côte en dessous de votre limite de rupture, maintenir l'élément à width: 100%, et répondre à onResize. Les en-têtes et pieds de page fixes ne doivent pas masquer les défis de l'émetteur ou les actions du widget.