Passa al contenuto principale
In questa pagina

Utilizzare Next Action quando un ordine esistente richiede al cliente di completare un ulteriore passaggio, come una sfida 3DS o un reindirizzamento supportato. Riutilizzare il token dell'ordine originale.

Per il 3DS, l’esperienza restituita può prima raccogliere i segnali del browser e del dispositivo e poi proseguire senza verifica o mostrare quella dell’emittente. Una schermata di caricamento non significa che il cliente debba autenticarsi manualmente. Mantieni il widget montato mentre gestisce il flusso e verifica l’ordine originale dopo un callback o un ritorno. Consulta il Flusso di acquisto 3DS per conoscere le fasi e gli esiti del pagamento.

Diagramma di flusso decisionale#

Diagramma di flusso
NoSìSuccessoErrore o chiusura1Crea o invia ilpagamento2È stata restituitaun’azionesuccessiva?3Gestisci lo statoattuale dell’ordine4Apri Next Action conlo stesso tokendell’ordine5Esito del widget6Riconcilia l’ordinesul backend7Recupera lo statoprima di riprovare8Evadi l’ordine soloda uno stato finaleverificato
RisultatoRevisione o in sospeso
01 · response
Rileva l'azione richiesta
Utilizza la risposta di pagamento o lo stato dell'ordine documentato.
02 · SDK
Apri Next Action
Passare l'ordine originale order_token; do not create another order.
03 · customer
Proseguire l’autenticazione
Lascia terminare i controlli del browser e presenta una verifica dell’emittente solo quando necessario. Mantieni funzionanti reindirizzamenti, popup e ritorno all’app.
04 · backend
Verifica il risultato
Recuperare l'ordine o consumare un webhook verificato.

Guarda l'esperienza del cliente#

Next Action funziona sia con i widget di pagamento DEUNA sia con i moduli di pagamento gestiti dall’esercente. Dopo che il backend ha inviato il pagamento, apri Next Action solo quando la risposta indica che il cliente deve completare un altro passaggio. Il widget presenta la sfida 3DS supportata o il reindirizzamento a un metodo di pagamento alternativo (APM) e comunica il risultato tramite i callback.

La dimostrazione seguente mostra come l’esperienza prosegue dal checkout dell’esercente all’azione post-pagamento richiesta:

Next Action presenta il passaggio che il cliente deve completare dopo l’avvio del pagamento. Guarda il video direttamente su YouTube se il lettore incorporato non è disponibile.

Il video illustra la transizione mostrata al cliente. L’integrazione deve comunque utilizzare la risposta del pagamento, i callback e la riconciliazione del backend descritti di seguito; non dedurre lo stato finale del pagamento da ciò che il cliente vede nel widget.

Apri Next Action#

await DeunaSDK.initNextAction({
  orderToken,
  callbacks: {
    onSuccess: () => verifyOriginalOrder(),
    onError: (error) => recoverAfterVerification(error),
    onClosed: () => recoverAfterVerification(),
  },
});

Parametri#

ParametroPiattaformeObbligatorioOggetto
orderTokenTuttiSì.Token originale per l'ordine in attesa di intervento del cliente.
callbacksTuttiSì.Supporto per gestori di successo, errore, chiusura, evento e ridimensionamento in base al contratto di callback di base.
languageTuttiNo.Localizza l'esperienza ospitata.
modeReazione nativoSì.Scegliere la presentazione modale o supportata.
fraudCredentialsNative + React NativeNo.Solo per un'integrazione configurata dei dati del dispositivo.
customUserAgentiOS + AndroidNo.Override dell'agente utente WebView approvato.
domainTuttiNo.Override dell'ambiente controllato; omettere nell'uso normale in produzione.

Gestire ogni risultato#

RisultatoChe cosa significaAzione corretta
onSuccessIl passaggio del cliente è stato completato.Recuperare l'ordine originale e renderlo dal suo stato corrente.
onErrorL'SDK o la sfida hanno segnalato un errore normalizzato.Registrare i metadati sicuri, recuperare lo stato e quindi offrire un tentativo valido.
onClosedIl cliente o l'SDK hanno chiuso l'esperienza.Considerare come ambiguo fino a quando lo stato del backend non è noto.
Timeout o interruzione dell'appNessun risultato affidabile del client è stato raggiunto dal gestore.Ricollocare dal backend; non inviare automaticamente di nuovo.

Requisiti di redirect e popup#

  • Consentire all'SDK di aprire la superficie di autenticazione esterna supportata.
  • Mantenere lo stato del ciclo di vita dell'app mentre il cliente esce e torna.
  • Sul Web, aprire da un'azione del cliente e non "sandboxare" il widget in modo da bloccare popup o la navigazione di livello superiore.
  • Su React Native, mantenere il renderer dell'SDK montato mentre il suo controller di redirect esterno è attivo.
  • Su iOS e Android, utilizzare il componente modale o integrato mantenuto dell'SDK invece di ricreare il ponte WebView interno.
  • Verifica, rifiuto, cancellazione da parte del cliente, timeout dell'emittente, perdita di connessione e ritorno dallo stato di background.

Presentazione integrata#

Il Web SDK supporta mode: 'target' più target; iOS e Android espongono componenti widget integrati; React Native utilizza il suo DeunaWidget renderer. Assicurarsi che l'altezza iniziale sia sufficiente, rispondere ai cambiamenti di dimensione e garantire che l'applicazione host non nasconda i controlli di sfida dietro un footer fisso o una tastiera sullo schermo.

Fallback di caricamento iframe 3DS#

Quando DEUNA presenta una sfida 3DS all'interno di un iframe, Next Action monitora lo stato di caricamento della vista dell'emittente.

  • Se l'iframe si carica correttamente entro i primi 5 secondi, il flusso prosegue normalmente e non vengono visualizzate azioni di recupero aggiuntive.
  • Se la vista non termina il caricamento dopo 5 secondi# La vista non si è caricata? appare l'opzione.

Quando espansa, l'acquirente può:

  • Ricarica vista: riprova a caricare la sfida 3DS.
  • Cambia metodo di pagamento: consente all'acquirente di abbandonare la sfida corrente e selezionare un altro metodo di pagamento, dopo aver confermato l'azione.

Se l'iframe termina il caricamento mentre il fallback è visibile, le opzioni di recupero vengono nascoste automaticamente e l'acquirente può proseguire con la sfida.

Comportamento di integrazione

AzioneComportamentoCallback / evento
Il pagamento passa alla vista 3DSViene visualizzata la vista embedded 3DS, oppure l'utente viene reindirizzato a un'altra scheda.evento paymentMethods3dsInitiated.
Caricamento iframeLa sfida 3DS prosegue normalmenteNon è richiesta alcuna azione aggiuntiva da parte del merchant
Cambia metodo di pagamentoL'esperienza corrente viene abbandonata dopo la confermaevento apmCancelPayment.
Sfida completataIl normale flusso Next Action proseguecallback onSuccess / evento purchase / risultato corrispondente
Sfida negata / scadutaSfida negata nel redirect, il flusso termina qui.evento purchaseError / callback onError

Il merchant deve continuare a utilizzare i callback Next Action e lo stato dell'ordine autorevole per determinare l'esito finale del pagamento.