Widget de bons de réduction

Le widget de réduction présente les instructions ou la référence générée pour un bon de réduction ou une méthode de paiement en espèces prise en charge. Il utilise un jeton de commande existant ; il ne crée pas ou ne paie pas une deuxième commande.

Cycle de vie du bon de réductionInterroger Athia à ce sujet#

Ouvrir le widgetInterroger Athia à ce sujet#

await DeunaSDK.initVoucherWidget({
  orderToken,
  language: 'en',
  callbacks: {
    onSuccess: (data) => showVoucherInstructions(data),
    onError: (error) => showRecovery(error),
    onClosed: () => showPaymentMethods(),
    onPaymentProcessing: () => disableDuplicateActions(),
  },
});

await deunaSDK.initVoucherWidget({
  orderToken,
  mode: 'modal',
  language: 'en',
  callbacks: {
    onSuccess: showVoucherInstructions,
    onError: showRecovery,
    onClosed: showPaymentMethods,
    onDownloadFile: ({type, data}) => saveVoucher({type, data}),
  },
});

let callbacks = VoucherCallbacks()
callbacks.onSuccess = { data in showVoucherInstructions(data) }
callbacks.onError = { error in showRecovery(error) }
callbacks.onClosed = { _ in showPaymentMethods() }

deunaSDK.initVoucher(
    orderToken: orderToken,
    callbacks: callbacks,
    language: "en"
)

val callbacks = VoucherCallbacks().apply {
    onSuccess = { data -> showVoucherInstructions(data) }
    onError = { error -> showRecovery(error) }
    onClosed = { showPaymentMethods() }
}

deunaSDK.initVoucherWidget(
    context = this,
    orderToken = orderToken,
    callbacks = callbacks,
    language = "en"
)

ParamètresInterroger Athia à ce sujet#

État de finalisation et de paiementInterroger Athia à ce sujet#

onSuccess signifie que l'expérience du bon de réduction a terminé son action client prise en charge. Le règlement du bon de réduction se produit généralement plus tard, en dehors de l'application. Conservez la commande en attente dans votre interface jusqu'à ce que votre backend observe l'état final via un webhook vérifié ou une récupération d'API.

Reçus et livraison de fichiersInterroger Athia à ce sujet#

Une réponse de paiement de référence peut contenir un reference_processors tableau. Chaque entrée de processeur disponible peut fournir un code-barres, une date d'expiration, le nom du processeur et une URL de reçu HTML ou PDF hébergé. Étant donné que ce champ est un tableau, l'expérience de reçu hébergée peut présenter plusieurs reçus lorsque le paiement traité renvoie plusieurs références de processeurs.

Le processeur détermine quels champs de reçu sont présents. Ne pas synthétiser une URL PDF à partir d'un code-barres, ni supposer que chaque méthode de référence dispose à la fois des formats HTML et PDF.

Pour React Native, basculez sur le discriminateur au lieu de supposer que le payload est toujours un corps de fichier :

import {DownloadType} from '@deuna/react-native-sdk';

const onDownloadFile = async ({type, data}) => {
  if (type === DownloadType.URL) {
    await openTrustedReceiptUrl(data);
    return;
  }

  await saveBase64VoucherImage(data);
};

Validez toute URL avant de l'ouvrir ou de la récupérer, utilisez HTTPS, conservez les fichiers téléchargés dans un emplacement approprié et protégé ou sélectionné par l'utilisateur, et ne pas enregistrer le contenu des reçus. Un reçu enregistré est une preuve pour le client ; ce n'est pas une confirmation de règlement de paiement officielle.

Mobile et accessibilitéInterroger Athia à ce sujet#

• Afficher le code promo à partir d'un écran visible, et non d'un appel de fond.
• Assurer que les actions de téléchargement, de copie et de fermeture restent accessibles avec une taille de texte de 200 %.
• Sur React Native, demander uniquement les capacités de stockage ou de partage nécessaires à votre implémentation de sauvegarde.
• Restaurer le focus sur le contrôle qui a ouvert le modal et signaler les erreurs de chargement via l'API d'accessibilité de la plateforme.
• Tester avec de longs noms de commerçants, de longues instructions traduites et des appareils de petite taille.

DépannageInterroger Athia à ce sujet#

Références connexesInterroger Athia à ce sujet#