Flusso di acquisto 3DS
Mantenere l'autenticazione in attesa, presentare la prossima azione e confermare lo stato di pagamento finale.
In questa pagina
Invia il pagamento con carta una sola volta, presenta l’eventuale azione 3DS successiva restituita e verifica il risultato del pagamento sul backend. L’esperienza di autenticazione può raccogliere segnali del browser, terminare senza una verifica o chiedere al cliente di autenticarsi presso la propria banca.
L’autenticazione può fallire o interrompersi in qualsiasi fase. Il diagramma mostra il percorso normale; lo stato attuale del pagamento determina se attendere, evadere l’ordine o offrire un recupero.
Responsabilità della tua integrazione#
Il backend crea il pagamento e ne verifica il risultato. Il checkout presenta l’azione restituita e mantiene il contesto dell’ordine originale. DEUNA coordina i controlli del browser, l’autenticazione e l’eventuale autorizzazione rimanente con il provider collegato; l’emittente controlla la verifica e la decisione di autenticazione.
Non creare una tua sequenza di chiamate di autenticazione al provider e non presumere che ogni passaggio del diagramma richieda una richiesta API separata del commerciante. Usa l’azione restituita tramite l’integrazione supportata per la tua connessione.
1. Creare il pagamento#
Utilizzare o modello di pagamento della carta supportato:
- Creare un ordine con Creare ordine, poi pagarlo con Creare il pagamento.
- Utilizzare la singola richiesta Creare il pagamento scorre quando si adatta alla vostra integrazione.
Inviare informazioni complete shopper, fatturazione, ordine e dispositivo. Questi segnali aiutano l'emittente a decidere se l'autenticazione può essere senza attrito.
2. Ispezionare la risposta di pagamento#
Una risposta 3DS in attesa può includere i campi seguenti. Questo esempio mostra solo i campi necessari per proseguire il flusso:
{
"order": {
"payment": {
"data": {
"status": "pending_3ds",
"next_action": {
"action": "authorization_3ds",
"authorization_3ds": {
"url_challenge": "https://api.deuna.io/transactions/next-action/NEXT_ACTION_ID"
}
}
}
}
}
}Utilizzare questi campi come fonte di verità:
| Campo | Significato | Azione |
|---|---|---|
order.payment.data.status | pending_3ds significa che il flusso di pagamento 3DS è irrisolto. | Blocca l’evasione dell’ordine e gestisci l’azione restituita. |
order.payment.data.next_action.action | Identificare l'azione del cliente richiesta. | Maniglia authorization_3ds con i dati di sfida supportati DEUNA SDK o restituiti. |
order.payment.data.next_action.authorization_3ds.url_challenge | URL DEUNA per il passaggio di autenticazione successivo, che può includere controlli del browser prima di una verifica. | Usa esattamente l’URL restituito nella modalità di presentazione supportata per la connessione. |
Per la compatibilità, alcune integrazioni possono anche ricevere un livello superiore authorization_3ds oggetto. Le nuove implementazioni dovrebbero preferire next_action.
3. Presentare l'azione successiva#
SDK Web
Uso initNextAction(...) quando si desidera DEUNA per gestire il comportamento modale, iframe o reindirizzato supportato. Vedi il Riferimento Web SDK.
Se un Payment Widget DEUNA gestisce già il percorso di pagamento, lascia che quel widget gestisca l’azione restituita. Non aprire una seconda istanza di Next Action per lo stesso tentativo. Per un modulo di pagamento gestito dal commerciante, consulta il Widget Next Action.
Integrazione diretta del browser
Se gestisci la prossima azione da solo:
- Utilizzare il restituito
url_challenge; non costruire un URL 3DS. - Seguire la modalità di presentazione configurata. Non forzare una pagina emittente in un iframe quando è necessario un reindirizzamento di livello superiore.
- Conserva il tuo successo, il tuo fallimento e gli URL di ritorno.
- Trattare una finestra chiusa, il callback, o reindirizzare come segnale per recuperare lo stato, non come successo di pagamento.
Applicazioni native
Utilizzare il supporto DEUNA SDK o una visualizzazione sicura del browser/web del sistema. Configurare il link di ritorno/biglietto e ripristinare il contesto di pagamento quando il cliente ritorna all'app.
Controlli del browser prima di una verifica
L’esperienza restituita può raccogliere segnali del browser e del dispositivo prima che l’emittente decida se richiedere una verifica. Questo passaggio non richiede che il cliente inserisca un codice o approvi un pagamento. Mantieni disponibili la schermata di caricamento e l’interfaccia di autenticazione finché il flusso non prosegue.
Se la raccolta dei dati del browser non termina entro il proprio periodo di attesa, il flusso gestito può continuare con quel risultato. Questo, da solo, non significa che l’autenticazione sia fallita o che il pagamento sia riuscito. Non sostituire l’azione restituita con un errore basato su un timer locale e non avviare un altro acquisto.
4. Attendere lo stato di pagamento finale#
La conclusione dei controlli del browser, il completamento della verifica, un URL di ritorno e un callback dell’SDK sono segnali per riconciliare l’ordine originale. Nessuno dimostra che i fondi siano stati incassati. L’autenticazione può terminare insieme all’autorizzazione, oppure DEUNA potrebbe dover completare il pagamento in seguito.
Usate entrambi:
- i webhook sullo stato del pagamento configurati e verificati per gli aggiornamenti del backend; e
- Ordinare quando il cliente ritorna o quando il sistema ha bisogno di conciliare un risultato incerto.
| Risultato | Significato | Azione di adempimento |
|---|---|---|
processed | Acquisto completato. | Complimenti una volta che i tuoi controlli di affari passano. |
authorized | I fondi sono stati autorizzati ma non catturati. | Segui la tua strategia di cattura; non trattarti come catturato. |
pending_3ds | Il flusso 3DS è ancora irrisolto, con o senza una verifica visibile. | Mantieni disponibile l’esperienza attuale; non evadere l’ordine e non riavviare automaticamente. |
pending, processing, o authorizing | Il pagamento è ancora in corso. | Continua la riconciliazione; non inviare un nuovo acquisto per completare il 3DS. |
denied, cancelled, o expired | Il pagamento non è stato completato. | Mostra un risultato recuperabile e inizia un nuovo tentativo solo quando necessario. |
Vedi Flusso di lavoro di pagamento & Stati per ogni stato di pagamento pubblico e transizione.
5. Maniglia l'autenticazione senza attrito#
Frictionless significa che il cliente non completa alcuna verifica dell’emittente. Può comunque richiedere l’esperienza browser restituita per raccogliere i segnali del dispositivo e consentire il proseguimento dell’elaborazione del pagamento. Il codice deve supportare entrambi gli esiti:
- uno stato di pagamento immediato o in corso; o
pending_3dspiù unauthorization_3dsprossima azione.
Non è necessario che la presenza di un URL di sfida per determinare se 3DS è stato valutato.
Un pagamento riuscito senza verifica non dimostra, da solo, che l’autenticazione 3DS sia riuscita. Usa i dettagli di autenticazione riportati quando necessari per il supporto o l’analisi della responsabilità.
6. Timeout e ritiri#
La raccolta dei dati del browser, il caricamento della schermata di verifica, l’autenticazione dell’emittente e l’elaborazione del pagamento hanno periodi di attesa diversi. Un ritardo di caricamento o un timeout locale non determina l’esito del pagamento. Conferma la finestra di autenticazione applicabile alla connessione durante la certificazione; non impostare una durata universale fissa per le verifiche.
- Non riutilizzare un URL di sfida scaduto.
- Non creare ripetuti tentativi di pagamento mentre il primo pagamento rimane irrisolto.
- Utilizzare lo stato finale e
allow_retry/ guida di errore standardizzata quando disponibile prima di offrire un altro tentativo. - Se il routing seleziona un'altra connessione compatibile, lascia che DEUNA decida se un risultato di autenticazione esistente può essere riutilizzato.
Dopo la chiusura di una schermata, un’interruzione di rete o un timeout, recupera l’ordine originale prima di offrire un altro tentativo. Se il pagamento è ancora irrisolto, mostra un risultato in attesa e continua la riconciliazione. Se non è riuscito, applica l’errore e l’idoneità al nuovo tentativo riportati. La chiusura sul client non garantisce l’annullamento del pagamento sul backend.
7. Interpretare i dettagli di autenticazione in modo sicuro#
DEUNA Admin può visualizzare i risultati tecnici 3DS come la versione del protocollo, il tipo di flusso, ECI, il risultato di autenticazione e gli identificatori di transazione di rete. Utilizzare per sostenere, riconciliazione e analisi delle controversie.
Non memorizzare o esporre criptogrammi grezzi, risposte di autenticazione completa, o sfidare HTML nei registri dei commercianti. Uno stato di pagamento, non un ECI o un evento di completamento sfida, controlla l'adempimento.