Réponses et appels de retour du SDK

Chaque SDK DEUNA renvoie des résultats UI immédiats via des appels de retour. L'objet de succès exact dépend de l'expérience ouverte, tandis que les actions de fermeture, la détection de BIN et la sélection d'installations utilisent des contrats plus petits.

Anatomie de la réponseInterroger Athia à ce sujet#

Matrice de notificationsInterroger Athia à ce sujet#

Types Web et React NativeInterroger Athia à ce sujet#

type ClosedAction = 'userAction' | 'systemAction';

type SdkError = {
  type: string;
  metadata: {
    code: string;
    message: string;
  };
};

type CardBinDetected = {
  cardBin: string;
  cardBrand: string;
};

type InstallmentSelected = {
  cardBin: string;
  installmentPlanOptionId: string;
};

type Dimensions = {
  height: number;
  width: number;
};

Gérer les erreurs par catégorie, tout en conservant le code du fournisseur ou de l'expérience pour le diagnostic technique :

const callbacks = {
  onSuccess: async (data) => {
    setCheckoutState('verifying');
    const verifiedOrder = await fetch(`/api/orders/${merchantOrderId}`).then(r => r.json());
    renderFromAuthoritativeState(verifiedOrder);
  },
  onError: ({type, metadata}) => {
    logSafeDiagnostic({type, code: metadata.code});
    showRecoveryMessage(type, metadata.code);
  },
  onClosed: (action, metadata) => {
    restorePaymentMethods();
    if (metadata) logSafeDiagnostic({action, code: metadata.code});
  },
};

Types d'erreurs natifsInterroger Athia à ce sujet#

Les SDK iOS et Android normalisent les erreurs de paiement en PaymentsError et type, facultatif metadata, et un résultat facultatif order snapshot.

callbacks.onError = { error ->
    val code = error.metadata?.code ?: "UNKNOWN_ERROR"
    logger.warn("DEUNA SDK error", mapOf("type" to error.type.name, "code" to code))
    renderRecovery(error.type)
}

callbacks.onError = { error in
    let code = error.metadata?.code ?? "UNKNOWN_ERROR"
    logger.warning("DEUNA SDK error: \(error.type) / \(code)")
    renderRecovery(error.type)
}

Le succès est spécifique à l'expérienceInterroger Athia à ce sujet#

Le modèle de commande évolue indépendamment du système de rappel des SDK. Utilisez le endpoint API afin de correspondre au schéma backend actuel plutôt que de copier des champs arbitraires provenant d'un payload client.

Gestion intégrée de la redimensionnementInterroger Athia à ce sujet#

const host = document.querySelector('#deuna-widget');

await DeunaSDK.initPaymentWidget({
  orderToken,
  mode: 'target',
  target: '#deuna-widget',
  callbacks: {
    onResize: ({height}) => {
      host.style.height = `${Math.ceil(height)}px`;
    },
    onSuccess: verifyOrder,
    onError: showRecovery,
  },
});

Assurez une hauteur minimale stable à l'hôte pendant le chargement de l'iframe, puis... onResize Mettez-le à jour. Sur les petits écrans, évitez une largeur fixe en pixels et permettez à l'hôte de remplir la fenêtre d'affichage.

Vérification de sécuritéInterroger Athia à ce sujet#

• Assurez-vous que les fonctions de rappel sont idempotentes; les signaux de cycle de vie peuvent se produire lors de la navigation ou des tentatives.
• Désactivez la soumission en double pendant onPaymentProcessing et lorsque submit() est en attente.
• Affichez une représentation lisible par l'utilisateur à partir d'une liste blanche. Ne divulguez pas les messages bruts du fournisseur par défaut.
• Journal type, code d'erreur sécurisé, version du SDK, environnement et ID de corrélation du commerçant – sans informations d'identification ni données de carte.
• Restaurer le focus lors de la fermeture d'une fenêtre modale et annoncer les erreurs via une zone accessible en temps réel.
• Vérifiez l'état actuel de la commande après une fermeture ambiguë, un délai d'attente ou une interruption du réseau.

Contrats de sources publiquesInterroger Athia à ce sujet#

Les formats de retour sont vérifiés par rapport à la configuration actuelle. Interfaces de rappel web, Interfaces de rappel React Native, Base de gestion des appels de retour pour iOSet Appels de retour partagés pour Android. Utilisez la version installée par votre application lors de l'utilisation d'un référentiel. main La branche est plus récente que votre version stable.

Références connexesInterroger Athia à ce sujet#