Risposte e callback del SDK

Ogni DEUNA SDK restituisce risultati immediati nell'interfaccia utente tramite callback. L'oggetto di successo esatto dipende dall'esperienza aperta, mentre errori, azioni di chiusura, rilevamento BIN e selezione della rateizzazione utilizzano contratti più piccoli.

Struttura della rispostaChiedi ad Athia informazioni#

Matrice dei callbackChiedi ad Athia informazioni#

Tipi Web e React NativeChiedi ad Athia informazioni#

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;
};

Gestisci gli errori per categoria, mantenendo il codice del provider o dell'esperienza per la diagnostica di supporto:

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});
  },
};

Tipi di errore nativiChiedi ad Athia informazioni#

Gli SDK per iOS e Android normalizzano gli errori di pagamento in PaymentsError con type, opzionale metadatae un opzionale 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)
}

Il successo è specifico per l'esperienzaChiedi ad Athia informazioni#

Il modello dell'ordine si evolve in modo indipendente dal flusso di callback dell'SDK. Utilizza il endpoint API di riferimento per lo schema backend corrente, anziché copiare campi arbitrari da un payload del client.

Gestione integrata del ridimensionamentoChiedi ad Athia informazioni#

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,
  },
});

Fornire all'host un'altezza minima stabile mentre l'iframe viene caricato, quindi consentire onResize di aggiornarla. Su schermi piccoli, evitare una larghezza fissa in pixel e consentire all'host di riempire l'area di visualizzazione.

Controllo di sicurezzaChiedi ad Athia informazioni#

• Mantenere le funzioni di callback idempotenti; i segnali di ciclo di vita possono verificarsi durante la navigazione o i tentativi di ripristino.
• Disabilitare la duplicazione durante onPaymentProcessing e mentre submit() è in attesa.
• Visualizzare una copia leggibile dall'utente da un elenco consentito. Non esporre i messaggi del provider grezzi per impostazione predefinita.
• Log type, codice di errore sicuro, versione SDK, ambiente e ID di correlazione del commerciante – non credenziali o dati della carta.
• Ripristina il focus quando una finestra modale si chiude e comunica gli errori tramite una regione di notifica accessibile.
• Verificare lo stato attuale dell'ordine dopo una chiusura ambigua, un timeout o un'interruzione di rete.

Contratti di origine pubblicaChiedi ad Athia informazioni#

Le forme di callback vengono verificate rispetto allo stato corrente. Interfacce di callback web, Interfacce di callback per React Native, Base di callback per iOSe Callback condivisi per Android. Utilizzare la versione installata dalla tua applicazione quando si utilizza un repository. main Ramo più recente rispetto alla versione "pinned".

Riferimenti correlatiChiedi ad Athia informazioni#