Widget per voucher

Il widget del voucher presenta le istruzioni o il riferimento generato per un voucher o un metodo di pagamento in contanti supportato. Utilizza un token di ordine esistente; non crea o paga un secondo ordine.

Ciclo di vita del voucherChiedi ad Athia informazioni#

Apri il widgetChiedi ad Athia informazioni#

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"
)

ParametriChiedi ad Athia informazioni#

Completamento e stato del pagamentoChiedi ad Athia informazioni#

onSuccess significa che l'esperienza del voucher ha completato l'azione del cliente supportata. Il pagamento del voucher avviene comunemente in seguito, al di fuori dell'app. Mantenere l'ordine in stato di attesa nella propria interfaccia fino a quando il backend non osserva lo stato finale tramite un webhook verificato o un recupero API.

Ricevute e consegna fileChiedi ad Athia informazioni#

Una risposta di pagamento di riferimento può contenere un reference_processors Ogni voce di processore disponibile può fornire un codice a barre, la data di scadenza, il nome del processore e l'URL di un foglio di calcolo o PDF di ricevuta ospitato. Poiché questo campo è un array, l'esperienza di ricevute ospitate può presentare più ricevute quando il pagamento elaborato restituisce più riferimenti di processore.

Il processore determina quali campi sono presenti nella ricevuta. Non generare un URL PDF da un codice a barre o presumere che ogni metodo di riferimento disponga sia di formati HTML che PDF.

Per React Native, utilizzare il discriminatore invece di presumere che il payload sia sempre un corpo di file:

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

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

  await saveBase64VoucherImage(data);
};

Validare qualsiasi URL prima di aprirlo o recuperarlo, utilizzare HTTPS, conservare i file scaricati in una posizione appropriata e protetta o selezionata dall'utente, e non registrare il contenuto della ricevuta. Una ricevuta salvata è una prova a favore del cliente; non è una conferma definitiva di pagamento.

Mobile e accessibilitàChiedi ad Athia informazioni#

• Presentare il buono da uno schermo visibile, non da un callback di sfondo.
• Mantenere raggiungibili le azioni di download, copia e chiusura con un testo del 200%.
• Su React Native, richiedere solo le capacità di archiviazione o condivisione necessarie per la sua implementazione di salvataggio.
• Ripristinare il focus sul controllo che ha aperto il modale e annunciare gli errori di caricamento tramite l'API di accessibilità della piattaforma.
• Testare con nomi di commercianti lunghi, istruzioni localizzate lunghe e dispositivi stretti.

Risoluzione dei problemiChiedi ad Athia informazioni#

Riferimenti correlatiChiedi ad Athia informazioni#