Passa al contenuto principale
In questa pagina

Collega il tuo account Worldpay in DEUNA Admin, quindi configura Worldpay per inviare aggiornamenti sulle transazioni a DEUNA. Entrambi i passaggi sono importanti: il salvataggio di una connessione aggiunge le tue credenziali, mentre le notifiche consentono a DEUNA di riconciliare i risultati del pagamento dopo l'elaborazione.

01
Preparati
Conferma l'accesso all'account, le credenziali e le operazioni supportate.
02
Connettiti in DEUNA
Aggiungi Worldpay e scegli la modalità di elaborazione dei pagamenti.
03
Configurare le notifiche
Abilita gli eventi Worldpay che mantengono aggiornato DEUNA.
04
Verificare il flusso
Testare i risultati del pagamento prima di utilizzare le credenziali di produzione.

Prima di iniziare#

Questa guida è rivolta a chi gestisce le connessioni di pagamento della propria attività o del proprio negozio. Devi poter accedere a Connessioni in DEUNA Admin e a Worldpay Merchant Administration Interface (MAI). Se necessario, richiedi gli accessi all’amministratore dell’account.

Conferma il tuo account e le tue credenziali

Tieni pronto quanto segue per l'ambiente che stai configurando:

  • Un account Worldpay abilitato e il relativo ID commerciante.
  • Le credenziali di connessione XML Worldpay, inclusi i valori indicati da DEUNA come Chiave privata e Chiave pubblica.
  • Le credenziali di accesso a Worldpay MAI per configurare le notifiche.
  • Accesso al commerciante o al negozio in cui verrà creata la connessione DEUNA.

Richiedi queste credenziali al tuo rappresentante Worldpay. Confermare che le credenziali supportano l'operazione e l'ambiente selezionati; Le credenziali di accesso MAI e le credenziali di connessione XML hanno scopi diversi. Inserisci le credenziali di connessione solo nell'amministratore DEUNA e tienile lontane dal codice di pagamento, dagli screenshot e dai messaggi di supporto.

Conferma la disponibilità del pagamento

Controlla il catalogo delle funzionalità Worldpay per il mercato, la valuta, i marchi delle carte e le operazioni richieste. La disponibilità dipende dall'account e dalla connessione; le descrizioni delle funzionalità riportate di seguito non implicano che tutte le funzionalità siano abilitate per ogni commerciante.

Conferma con Worldpay i requisiti di acquiring locale e di entità giuridica per ciascun paese. Se userai 3-D Secure, rate, wallet o più operazioni parziali, concorda la configurazione necessaria con DEUNA e Worldpay prima dei test.

Valute accettate

ARS · BRL · EUR · GBP · JPY · MXN · USD

La disponibilità delle valute dipende dall’account commerciante Worldpay e dalla connessione. Conferma le valute abilitate per il tuo account prima dei test.

1. Collegare Worldpay a DEUNA#

Apri DEUNA Admin, seleziona l’attività o il negozio desiderato e apri Connessioni. In Scopri, cerca Worldpay e seleziona Connetti.

L’anteprima mostra la ricerca di Worldpay, la configurazione delle credenziali e la connessione salvata. I controlli sono illustrativi; configura l’account effettivo in DEUNA Admin.

DEUNA Admin · Anteprima della configurazione
ConnessioniSandbox
ScopriAttive
Cerca connessioni
Worldpay
Gateway di pagamentoWorldpay
Configurazione illustrativa. Nessuna credenziale viene inviata.

Inserisci le impostazioni di connessione

  1. Scegli un nome di connessione riconoscibile in modo che il tuo team possa distinguerlo da altri account o ambienti.
  2. Seleziona la valuta quando richiesto e inserisci le credenziali Worldpay emesse per quella connessione.
  3. Scegli Acquista per autorizzare e richiedere l'acquisizione in un unico flusso di pagamento oppure Autorizzazione se invierai una richiesta di acquisizione separata in un secondo momento.
  4. Configura 3-D Secure solo dopo aver confermato il flusso di autenticazione supportato con DEUNA. Vedi Movimentazione sicura 3D prima di implementare il pagamento.
  5. Selezionare Connetti, quindi verificare che Worldpay venga visualizzato in Connessioni attive.
Campo DEUNAValore da inserire
Merchant IDL'ID commerciante Worldpay emesso per la connessione.
Chiave privataLa chiave privata XML Worldpay.
Chiave pubblicaLa password pubblica XML Worldpay.

Per i pagamenti aerei, completa anche i campi dell'emittente richiesti dalla tua configurazione: Nome dell'emittente, Indirizzo dell'emittente1, Codice postale dell'emittente, Città dell'emittente e Codice paese dell'emittente. Identificano la compagnia aerea che emette il biglietto; utilizzare un codice paese ISO a due lettere per il proprio paese. Non sostituiscono i dati del passeggero, del biglietto e dell'itinerario inviati con un pagamento.

Una connessione in Connessioni attive conferma che è stata salvata. Continua con le notifiche Worldpay e un test di pagamento prima di considerare l'integrazione come pronta.

2. Configurare le notifiche Worldpay#

Worldpay invia notifiche a DEUNA per aggiornare lo stato del pagamento dopo un’autorizzazione, un’acquisizione, un annullamento o un rimborso. Il tuo backend riceve gli aggiornamenti tramite una configurazione separata dei webhook DEUNA. Configura entrambi i percorsi se l’integrazione richiede aggiornamenti asincroni.

Vedi DEUNA notifiche sullo stato del pagamento per la configurazione lato commerciante.

Imposta l'indirizzo di notifica

In Worldpay MAI, apri Integration → Merchant Channel. Nel http riga, insieme Active a Yes, impostato Method a POSTe inserisci l'indirizzo di notifica per l'ambiente corrispondente.

AmbienteIndirizzo di notifica Worldpay
Sabbierahttps://api.sandbox.deuna.io/transactions/webhooks/payconnect/payment-processors/worldpay
Produzionehttps://api.deuna.io/transactions/webhooks/payconnect/payment-processors/worldpay

Conferma l'indirizzo con DEUNA per la tua connessione prima di salvarlo. Worldpay chiama questo indirizzo; l'applicazione non lo chiama per creare un pagamento o recuperarne lo stato.

Worldpay MAI: use the http row to configure notification delivery. Labels in Worldpay's own interface may differ from your documentation language.

Abilita eventi di transazione

In Merchant Channel Events (Production), seleziona i seguenti eventi nel file http fila. Mantieni gli identificatori dell'evento esattamente come mostrati.

Fase di pagamentoEventi da abilitare
Autorizzazione ed erroriAUTHORIZED, REFUSED, ERROR
AcquisizioneCAPTURED, CAPTURE_FAILED
RimborsoSENT_FOR_REFUND, REFUNDED, REFUNDED_BY_MERCHANT, REFUND_REVERSED, REFUND_FAILED
Cancellazione e stornoSHOPPER_CANCELLED, CANCELLED, REVERSED, VOIDED, CANCEL_FAILED
Worldpay MAI: enable the listed events in the http row, then save the configuration.

3. Testare il flusso di pagamento completo#

Utilizza le credenziali sandbox e il flusso di pagamento supportato dalla tua connessione. Un test di connessione riuscito deve mostrare sia l'operazione di pagamento richiesta che il suo stato risultante.

Le richieste di acquisizione, rimborso e annullamento possono rimanere in sospeso durante l’elaborazione da parte di Worldpay. L’accettazione della richiesta, il ritorno del browser o un timeout non confermano l’esito finale. Usa lo stato aggiornato dell’ordine e i webhook DEUNA configurati per riconciliare il pagamento originale prima di riprovare o considerare conclusa l’operazione.

Vedi Flusso di lavoro di pagamento & Stati per il ciclo di vita dei pagamenti e DEUNA webhooks per le notifiche di backend.

Se il risultato atteso non arriva

  • Se non è possibile salvare la connessione, controllare l'account, l'ambiente, l'operazione e le credenziali XML selezionati con Worldpay.
  • Se un pagamento rimane in sospeso, controlla l'indirizzo di notifica Worldpay, POST metodo e selezionato http eventi prima di ritentare l'operazione originale.
  • Se DEUNA ha il risultato ma il tuo backend no, controlla il tuo Configurazione della consegna del webhook DEUNA.

Quando si passa a DEUNA, includere l'ambiente, il riferimento dell'ordine, l'operazione tentata e lo stato osservato. Non includere credenziali o dati completi della carta.

Passare alla produzione

Ripetere la configurazione della connessione e della notifica con le credenziali di produzione e l'indirizzo di notifica della produzione. Conferma le operazioni abilitate e gli eventuali requisiti di certificazione con DEUNA e Worldpay, quindi verifica il flusso di pagamento della produzione prima di accettare il traffico dei clienti.

Operazioni supportate#

Utilizza questo riferimento per scegliere il flusso di pagamento da configurare e testare. Conferma ciascuna funzionalità rispetto a catalogo delle funzionalità Worldpay e la configurazione del tuo account.

FunzionalitàCosa fa
AutorizzazioneRiserva l'importo richiesto sul conto del titolare senza acquisire i fondi. Per incassare il pagamento è necessaria un'acquisizione separata.
AcquisizioneIncassa i fondi di un pagamento precedentemente autorizzato. Un'acquisizione totale incassa l'importo autorizzato disponibile.
AcquistoAutorizza e richiede l'acquisizione in un unico flusso di pagamento, senza una richiesta di acquisizione separata del commerciante.
Acquisizione parzialeAcquisisce una parte dell'importo precedentemente autorizzato. Le acquisizioni multiple richiedono un'attivazione separata.
Acquisizioni parziali multipleConsente più acquisizioni sulla stessa autorizzazione, senza superare il saldo autorizzato disponibile. La modalità operativa e la validità dell'autorizzazione determinano come e quando inviarle.
AnnullamentoAnnulla un'autorizzazione non acquisita e richiede lo sblocco dell'importo ancora riservato. Non rimborsa i fondi già acquisiti.
RimborsiRestituisce al titolare i fondi acquisiti. Un rimborso totale restituisce il saldo rimborsabile residuo.
Rimborsi parzialiRestituisce al titolare una parte dell'importo acquisito.
Rimborsi parziali multipliConsente più rimborsi sullo stesso pagamento acquisito quando la funzione è attiva. Il totale rimborsato non può superare l'importo acquisito confermato.
Rateizzazione dell'emittenteConsente ai titolari idonei di suddividere un acquisto in rate secondo le condizioni supportate da emittente, acquirer e connessione del commerciante.
Portafogli digitaliSupporta pagamenti Apple Pay e Google Pay quando il portafoglio è disponibile e attivo per la connessione Worldpay.
MPI 3-D SecureDEUNA gestisce l'autenticazione 3-D Secure, inclusi i controlli del browser e una verifica dell'emittente quando richiesta. L'autenticazione può anche concludersi senza una verifica visibile.
Dati di linea aereaTrasmette le informazioni aeree supportate, inclusi dati di passeggeri, biglietti e itinerari. Fornisci i dati aerei richiesti dal tuo flusso di pagamento.

Acquisizioni e rimborsi multipli

Il supporto di acquisizioni e rimborsi parziali non attiva automaticamente le operazioni multiple. Conferma la modalità operativa e i limiti per ordine con il tuo Technical Account Manager (TAM) DEUNA e con Worldpay.

In modalità online, ogni acquisizione viene inviata singolarmente a Worldpay e non usa una scadenza di acquisizione DEUNA. Restano validi i limiti di acquisizione e la validità dell'autorizzazione Worldpay. Il periodo configurato in DEUNA si applica alle acquisizioni accumulate (offline), per le quali DEUNA invia l'importo complessivo alla chiusura della sequenza. Consulta Acquisizioni parziali multiple per le regole di ciascuna modalità.

I rimborsi multipli devono rientrare nel saldo rimborsabile confermato. Se la connessione usa l'accumulo gestito da DEUNA, una richiesta parziale registra l'intenzione fino all'invio del rimborso complessivo; non significa che il cliente abbia ricevuto i fondi. Consulta Rimborsi parziali multipli per il flusso con accumulo.

Gestisci l’autenticazione 3-D Secure

Quando l'autenticazione richiede un'azione nel browser, DEUNA restituisce l'esperienza ospitata tramite l'azione successiva del pagamento. La tua integrazione la presenta con il widget, iframe o reindirizzamento supportato. I controlli del browser possono concludersi senza una verifica dell'emittente; il titolare la vede solo quando necessaria.

L'autenticazione riuscita non garantisce un pagamento approvato o acquisito. Conferma lo stato finale dopo che DEUNA ha completato l'autorizzazione o l'elaborazione restante. Segui il Flusso di acquisto 3DS per gestire l'azione successiva e il recupero.

Portafogli e rate

Completa il separato Apple Pay o Google Pay configurazione prima di offrire un portafoglio alla cassa. La disponibilità del portafoglio dipende dal mercato e dalla connessione.

Per le rate dell'emittente, offri solo termini idonei per la carta, l'acquirente e la connessione. Vedi Installazioni per configurare le campagne e inviare l'opzione scelta dal cliente.

Requisiti regionali e delle compagnie aeree#

Pagamenti delle compagnie aeree

Fornisci i dati della compagnia aerea richiesti dal tuo flusso nella richiesta di autorizzazione o cattura. Per un airline_order, i dati richiesti della compagnia aerea devono essere presenti in almeno una di tali richieste. Conferma le informazioni previste sui passeggeri, sul biglietto e sull'itinerario per la tua connessione prima del test.

Limiti di acquisizione e rimborso

Cattura prima della scadenza dell'autorizzazione. Confermare la finestra di acquisizione consentita con Worldpay e DEUNA; un limite di batching DEUNA non estende l'autorizzazione dell'emittente. I rimborsi non possono superare l'importo confermato. Segui il regole della modalità operativa prima di inviare più di un'operazione parziale.

Transazioni locali in Argentina

Per le transazioni acquisite localmente da Worldpay in Argentina, includere il codice postale, la provincia e il Paese dell'acquirente nella richiesta di autorizzazione:

  • billing_address.zipcode
  • billing_address.state_name
  • billing_address.country_code

Worldpay utilizza queste informazioni per la ritenuta fiscale provinciale. Se è assente, la ritenuta si basa sull'ubicazione del commerciante. Invia il codice ISO della provincia oppure il codice COMARB billing_address.state_name, non entrambi.

Codici delle province dell'Argentina
Codice provinciale COMARBCodice provinciale ISONome della Provincia
901AR-CCABA
909AR-PFormosa
919AR-DSan Luis
908AR-EEntre Rios
911AR-LLa Pampa
917AR-ASalta
906AR-HChaco
907AR-UChubut
910AR-YJujuy
920AR-ZSanta Cruz
903AR-KCatamarca
904AR-XCordova
912AR-FLa Rioja
922AR-GSantiago del Estero
918AR-JSan Juan
913AR-MMendoza
914AR-NMisiones
915AR-QNo.
916AR-RRio Negro
923AR-VTierra del Fuego
902AR-BBuenos Aires
921AR-SSanta Fe
924AR-TTucumán
905AR-WCorrientes

Prossimo passo#