Worldpay
Collega Worldpay a DEUNA, configura le notifiche di pagamento e verifica il flusso di pagamento completo prima di andare in diretta.
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.
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.
Inserisci le impostazioni di connessione
- Scegli un nome di connessione riconoscibile in modo che il tuo team possa distinguerlo da altri account o ambienti.
- Seleziona la valuta quando richiesto e inserisci le credenziali Worldpay emesse per quella connessione.
- 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.
- Configura 3-D Secure solo dopo aver confermato il flusso di autenticazione supportato con DEUNA. Vedi Movimentazione sicura 3D prima di implementare il pagamento.
- Selezionare Connetti, quindi verificare che Worldpay venga visualizzato in Connessioni attive.
| Campo DEUNA | Valore da inserire |
|---|---|
| Merchant ID | L'ID commerciante Worldpay emesso per la connessione. |
| Chiave privata | La chiave privata XML Worldpay. |
| Chiave pubblica | La 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.
| Ambiente | Indirizzo di notifica Worldpay |
|---|---|
| Sabbiera | https://api.sandbox.deuna.io/transactions/webhooks/payconnect/payment-processors/worldpay |
| Produzione | https://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.
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 pagamento | Eventi da abilitare |
|---|---|
| Autorizzazione ed errori | AUTHORIZED, REFUSED, ERROR |
| Acquisizione | CAPTURED, CAPTURE_FAILED |
| Rimborso | SENT_FOR_REFUND, REFUNDED, REFUNDED_BY_MERCHANT, REFUND_REVERSED, REFUND_FAILED |
| Cancellazione e storno | SHOPPER_CANCELLED, CANCELLED, REVERSED, VOIDED, CANCEL_FAILED |
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,
POSTmetodo e selezionatohttpeventi 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 |
|---|---|
| Autorizzazione | Riserva l'importo richiesto sul conto del titolare senza acquisire i fondi. Per incassare il pagamento è necessaria un'acquisizione separata. |
| Acquisizione | Incassa i fondi di un pagamento precedentemente autorizzato. Un'acquisizione totale incassa l'importo autorizzato disponibile. |
| Acquisto | Autorizza e richiede l'acquisizione in un unico flusso di pagamento, senza una richiesta di acquisizione separata del commerciante. |
| Acquisizione parziale | Acquisisce una parte dell'importo precedentemente autorizzato. Le acquisizioni multiple richiedono un'attivazione separata. |
| Acquisizioni parziali multiple | Consente più acquisizioni sulla stessa autorizzazione, senza superare il saldo autorizzato disponibile. La modalità operativa e la validità dell'autorizzazione determinano come e quando inviarle. |
| Annullamento | Annulla un'autorizzazione non acquisita e richiede lo sblocco dell'importo ancora riservato. Non rimborsa i fondi già acquisiti. |
| Rimborsi | Restituisce al titolare i fondi acquisiti. Un rimborso totale restituisce il saldo rimborsabile residuo. |
| Rimborsi parziali | Restituisce al titolare una parte dell'importo acquisito. |
| Rimborsi parziali multipli | Consente più rimborsi sullo stesso pagamento acquisito quando la funzione è attiva. Il totale rimborsato non può superare l'importo acquisito confermato. |
| Rateizzazione dell'emittente | Consente ai titolari idonei di suddividere un acquisto in rate secondo le condizioni supportate da emittente, acquirer e connessione del commerciante. |
| Portafogli digitali | Supporta pagamenti Apple Pay e Google Pay quando il portafoglio è disponibile e attivo per la connessione Worldpay. |
| MPI 3-D Secure | DEUNA 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 aerea | Trasmette 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.zipcodebilling_address.state_namebilling_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 COMARB | Codice provinciale ISO | Nome della Provincia |
|---|---|---|
| 901 | AR-C | CABA |
| 909 | AR-P | Formosa |
| 919 | AR-D | San Luis |
| 908 | AR-E | Entre Rios |
| 911 | AR-L | La Pampa |
| 917 | AR-A | Salta |
| 906 | AR-H | Chaco |
| 907 | AR-U | Chubut |
| 910 | AR-Y | Jujuy |
| 920 | AR-Z | Santa Cruz |
| 903 | AR-K | Catamarca |
| 904 | AR-X | Cordova |
| 912 | AR-F | La Rioja |
| 922 | AR-G | Santiago del Estero |
| 918 | AR-J | San Juan |
| 913 | AR-M | Mendoza |
| 914 | AR-N | Misiones |
| 915 | AR-Q | No. |
| 916 | AR-R | Rio Negro |
| 923 | AR-V | Tierra del Fuego |
| 902 | AR-B | Buenos Aires |
| 921 | AR-S | Santa Fe |
| 924 | AR-T | Tucumán |
| 905 | AR-W | Corrientes |
Prossimo passo#
- Strategie di pagamento: configura quando viene utilizzato l'account connesso.
- Flusso di acquisto 3DS: gestisce le azioni del browser, i risultati dell'autenticazione e il ripristino.
- Notifiche sullo stato dei pagamenti: mantieni il tuo backend allineato con DEUNA.