Nessun risultato trovato

POST/v2/svs/3dsPay

PROD
https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v2/svs/3dsPay
TEST
https://xpaysandbox.nexigroup.com/api/phoenix-0.0/psp/api/v2/svs/3dsPay

Autorizza un pagamento 3D Secure con un MPI esterno

PARAM HEADER
NOME DESCRIZIONE FORMATO
Correlation-Id Campo obbligatorio nel formato UUID v4.
Lo scopo di questo campo è tracciare la richiesta su diversi sistemi, semplificando il debug e il monitoraggio delle richieste.
 String
Formato: uuid
Esempio: 123e4567-e89b-12d3-a456-426614174000
Idempotency-Key Chiave di idempotenza per garantire richieste idempotenti. Viene utilizzato per prevenire operazioni duplicate in caso di problemi di rete o nuovi tentativi.
Il valore deve essere univoco per ogni richiesta e può contenere fino a 128 caratteri.
 String
X-Api-Key Chiave API di autenticazione. String
Formato: uuid
Esempio: 625b4884-38f8-11ed-a261-0242ac120002
PARAM PATH
NOME DESCRIZIONE FORMATO
No param path
PARAM QUERY
NOME DESCRIZIONE FORMATO
No param query
PARAM BODY

Payment authorization request

NOME DESCRIZIONE FORMATO
card Oggetto contenente i dati della carta di pagamento.
 Object
cvv Valore di convalida della carta, quando disponibile.
 String
Lunghezza min: 3
Lunghezza max: 4
Esempio: 123
expiryDate Data di scadenza della carta nel formato mmaa.
 String
Lunghezza min: 4
Lunghezza max: 5
Esempio: 1225
pan Carta PAN.
 String
Lunghezza min: 12
Lunghezza max: 19
Esempio: 1234567890123456
order Contiene le informazioni sull'ordine e i dati aggiuntivi necessari per specifici tipi di pagamento.
 Object
amount Importo della transazione nell'unità monetaria più piccola. 50 euro sono rappresentati
come 5000 (2 decimali) 50 JPY è rappresentato come 50 (0 decimali)
 String
Esempio: 3545
currency Valuta della transazione. Codice alfabetico ISO 4217
 String
Esempio: EUR
customField Descrizione aggiuntiva della transazione String
Lunghezza max: 255
Esempio: weekend promotion
customerId Identificatore del cliente calcolato dal commerciante per corrispondere al cliente registrato sulla piattaforma di e-commerce.
Utilizzare solo lettere, cifre, trattino basso (_) o trattino (-).
 String
Lunghezza max: 27
Esempio: mcid97295873
description Descrizione della transazione String
Lunghezza max: 255
Esempio: TV LG 3423
orderId ID ordine commerciante, univoco nel dominio commerciante String
Lunghezza max: 27
Esempio: btid2384983
plan Oggetto contenente i dettagli della descrizione del piano.
Puoi visualizzare il piano creato tramite il menu "subscription" nel tuo backoffice.
In base ai diversi valori di `planType`, il piano può essere utilizzato per scopi differenti:
- FIXED: ogni rata ha lo stesso importo e date di scadenza specificate.
- VARIABLE: ogni rata può avere un importo diverso e date di scadenza specificate.
- ACQUIRER_AGREEMENT: gestito dall'accordo con l'acquirer, il numero di rate e l'importo di ciascuna rata sono definiti dall'acquirer.
 Object
contractId Identificatore del contratto.
Il valore deve essere lungo tra 1 e 18 caratteri. Per mantenerlo unico, utilizza un commerciante stabile o un prefisso di canale insieme a una sequenza monotona, un timestamp o un riferimento al contratto della piattaforma, evitando il riutilizzo per diversi contratti ricorrenti.
 String
Lunghezza min: 1
Lunghezza max: 18
Esempio: C2834987
planType Valori possibili:
- FIXED: ogni rata ha lo stesso importo e date di scadenza specificate.
- VARIABLE: ogni rata può avere un importo diverso e date di scadenza specificate.
- ACQUIRER_AGREEMENT: gestito dall'accordo con l'acquirer, il numero di rate e l'importo di ciascuna rata sono definiti dall'acquirer.
 String
status Valori possibili:
- ACTIVE: il piano è attivo e può essere utilizzato per le transazioni.
- INACTIVE: il piano è inattivo e non può essere utilizzato per le transazioni.
- COMPLETED: il piano è stato completato e tutte le rate sono state pagate.
 String
totalAmount Importo totale del piano nell'unità di valuta più piccola.
La valuta applicata è quella dell'ordine.
 String
termsAndConditionsIds Matrice di identificatori T&C della struttura. Inserimento di termini e condizioni
 Array
paymentSession Questo è l'oggetto base della sessione di pagamento per l'endpoint di pagamento.
Contiene le informazioni su importo, azione e capture.


Questo è l'oggetto della sessione di pagamento per l'endpoint di pagamento server-to-server.
Contiene l'url di notifica al quale verrà notificata la sessione di pagamento al termine del processo di pagamento.


Dati di autenticazione prodotti da un MPI (Mastercard SecureCode, Visa Secure)

Questo è l'oggetto della sessione di pagamento per l'endpoint di pagamento server-to-server.
Contiene i dati di autenticazione prodotti da un MPI (Mastercard SecureCode, Visa Secure).
I dati provenienti dall'MPI (Mastercard SecureCode, Visa Secure) sono necessari per eseguire il pagamento.
 Object
action Indica il tipo di operazione:
* PAY - esegue una transazione di pagamento
* VERIFY - effettua un'operazione di verifica, senza alcun addebito, con il solo scopo di confermare la validità dei dati della carta inseriti dal cliente
* PREAUTH - esegue un'operazione di preautorizzazione
 String
Default: PAY
Esempio: PAY
amount Importo del primo pagamento che può essere inferiore o uguale al'importo dell'ordine. 50 EUR sono rappresentati come 5000 (2 decimali) 50 JPY è rappresentato come 50 (0 decimali)
Funziona come descritto nella norma ISO 4217 		String
Esempio: 5000
capture Sovrascrive il metodo di conferma predefinito del terminale, solo per i pagamenti con carta:
* IMPLICITO - conferma automatica
*ESPLICITO - solo autorizzazione
Il valore predefinito dipende dalla configurazione del terminale.
1. Terminale impostato su ESPLICITO:
un. se captureType è EXPLICIT la cattura sarà EXPLICIT
b. se captureType non è presente o è nullo la cattura sarà ESPLICITA
c. se captureType è IMPLICIT la cattura sarà IMPLICITA

2. Terminale impostato su IMPLICITO:
un. se captureType è EXPLICIT l'acquisizione sarà un errore
b. se captureType non è presente o è nullo la cattura sarà IMPLICITA
c. se captureType è IMPLICIT la cattura sarà IMPLICITA
 String
Esempio: EXPLICIT
exemptions NO_PREFERENCE, CHALLENGE_REQUESTED
 String
Esempio: NO_PREFERENCE
mpiData Dati di autenticazione prodotti da un MPI (Mastercard SecureCode,\\Visa Secure) Object
authenticationResponse In 3D Secure 2, questo è il transStatus della sfida\\risultato.
Se la transazione è avvenuta senza intoppi, ometti questo parametro.
 String
authenticationValue Il valore di autenticazione del titolare della carta (codificato base64, 20 byte in forma decodificata).
 String
challengeCancel Indicatore che informa il Server di Controllo Accessi (ACS)
e\ \ il Directory Server (DS) per il quale l'autenticazione è stata annullata.\ \
Per i valori possibili:
00\tL'elemento dati è assente o il valore è\\stato rispedito con la chiave challengeCancel.
01\tTitolare della carta selezionato\ \ Annulla.
02\t3DS Richiedente ha annullato l'autenticazione.
03\tTransazione\ \ abbandonata.
04\tTransazione scaduta in ACS - altri timeout.
\ \ 05\tTransazione scaduta in ACS: primo CReq non ricevuto da ACS.
\ \ 06\tErrore di transazione.
07\tSconosciuto.
08\tTransazione scaduta\ \ all'SDK.
 String
directoryResponse In 3D Secure 2, questo è il transStatus degli ARes.
 String
dsTransID Supportato per 3D Secure 2.
L'identificatore univoco della transazione\\ assegnato dal Directory Server (DS)
per identificare una singola transazione.
 String
eci L'indicatore del commercio elettronico.
-05
-06
-07
 String
riskScore Punteggio di rischio calcolato da Directory Server (DS).
 String
tokenAuthenticationVerificationValue Valore di verifica dell'autenticazione del token di rete (TAVV).
\ Il crittogramma del token di rete.
 String
transStatusReason Fornisce informazioni sul motivo per cui il campo transStatus ha il\ \ valore specificato.
Si consiglia vivamente di inviarlo durante l'autorizzazione.
\ \ - 01(Autenticazione della carta fallita)
- 02(Dispositivo sconosciuto)
- 03(Non supportato\\Dispositivo)
- 04(Supera il limite di frequenza di autenticazione)
- 05(Carta scaduta\\)
- 06(Numero di carta non valido)
- 07(Transazione non valida)
\ \ - 08(Nessuna registrazione della tessera)
- 09(Errore di sicurezza)
- 10(Carta rubata)\ \
- 11(Sospetta frode)
- 12(Transazione non consentita al titolare della carta)
\ \ - 13(Titolare non iscritto al servizio)
- 14(Transazione scaduta\\scaduta presso l'ACS)
- 15 (bassa confidenza)
- 16(Confidenza media)\ \
- 17(Alta confidenza)
- 18 (confidenza molto alta)
- 19(Supera le sfide massime\\ACS)
- 20(Transazione senza pagamento non supportata)
\ \ - 21(transazione 3RI non supportata)
- 22(Problema tecnico ACS)
\ \ - 23(Autenticazione disaccoppiata richiesta da ACS ma non richiesta dal\ \ Richiedente 3DS)
- 24 (Tempo di scadenza massimo disaccoppiato del richiedente 3DS superato)
\ \ - 25(L'autenticazione disaccoppiata non ha avuto tempo sufficiente per autenticare il titolare della carta.\ \ ACS non effettuerà alcun tentativo)
- 26(Autenticazione tentata ma non\\eseguita dal titolare della carta)
- 27–79 (Riservato per uso futuro EMVCo)
\ \ - 80–99(Riservato per uso DS)
 String
Lunghezza min: 2
Lunghezza max: 2
Esempio: 02
transType Identifica il tipo di transazione da autenticare (derivato da ISO8583).
Valori accettati:
- 01 = Acquisto di beni/servizi
- 03 = Verifica accettazione
- 10 = Finanziamento del conto
- 11 = Transazione quasi in contanti
- 28 = Attivazione e caricamento prepagato
 String
Lunghezza max: 2
version La versione del protocollo 3D Secure su cui è registrata la carta
Questo elenco è soggetto a modifiche nel tempo.
- 1.0
- 2.1
- 2.2
- 2.3
 String
notificationUrl Questo è l'url al quale verrà notificata la sessione di pagamento
al termine del processo di pagamento.
si prega di consultare la documentazione per il payload della notifica.
 String
Esempio: https://my.server.com/xpay/notify
recurrence Definisce le impostazioni per un pagamento ricorrente. Le impostazioni vengono utilizzate per creare un contratto che può essere usato per i pagamenti successivi.
Il contenuto di questo oggetto può variare in base a `contractType`, fare riferimento allo specifico tipo di contratto per maggiori dettagli.
 Object
contractId Il contractId è un identificatore univoco del contratto.
Viene generato dai sistemi degli esercenti e viene utilizzato per identificare il contratto nei pagamenti successivi.
 String
Lunghezza min: 1
Lunghezza max: 18
Esempio: C2834987
contractType Definisce la tipologia di contratto che verrà utilizzata per i successivi\\ pagamenti:
* CIT - il contratto può essere utilizzato solo per pagamenti successivi\\ disposti dal cliente.
* MIT_SCHEDULED - il contratto può essere utilizzato\ \ per transazioni programmate avviate dal commerciante. Il numero di giorni tra\\ un pagamento e l'altro dovrà essere pari o superiore al valore di contractFrequency.
\ * MIT_UNSCHEDULED - il contratto può essere utilizzato per transazioni non programmate avviate dal commerciante. Il valore contractFrequency non ha alcun effetto in questo caso.
 String
Esempio: CIT
recurringAction Definisce l'azione per un pagamento ricorrente:
* **SUBSEQUENT_PAYMENT** – Pagamento “OneClick” utilizzando un contratto esistente
* **CONTRACT_CREATION** – Creazione di un nuovo contratto
* **CARD_SUBSTITUTION** – Sostituzione della carta legata ad un contratto in essere (Nota: solo per contratti creati con la modalità di pagamento CARD)
 String
Esempio: CONTRACT_CREATION
Arrow RESPONSE 200
Disattivazione riuscita - Nessun header per questa risposta
BODY
NOME DESCRIZIONE FORMATO
operation Oggetto contenente i dettagli di un'operazione di pagamento.
 Object
additionalData Mappa dei campi aggiuntivi specifici per il metodo di pagamento scelto
 Object
cancelledOperationId L'operazione deve essere annullata
 String
channel Indica il canale di origine:
* ECOMMERCE: il titolare della carta ha avviato l'operazione attraverso un canale online.
* POS: il titolare della carta ha avviato l'operazione tramite un POS fisico.
* BACKOFFICE: operazione avviata dal commerciante. Comprende le operazioni postali e il MIT.
 String
Esempio: ECOMMERCE
customerInfo Oggetto contenente il dettaglio del cliente. L'invio del contenuto di questo oggetto aumenta il livello di sicurezza della transazione, aumentando quindi la probabilità che nel pagamento non venga richiesta l'autenticazione a due fattori.
 Object
billingAddress Oggetto contenente il dettaglio dell'indirizzo del cliente.
 Object
additionalInfo Informazioni aggiuntive sull'indirizzo, ad esempio il piano.
Lunghezza massima consigliata: 50 caratteri.
 String
Esempio: Quinto Piano, Scala B
city Città.
Lunghezza massima consigliata: 40 caratteri.
 String
Esempio: Bologna
country Stato nel codice ISO 3166-1 alpha-3.
Lunghezza massima consigliata: 3 caratteri.
 String
Esempio: ITA
name Nome e cognome.
Lunghezza massima consigliata: 50 caratteri.
 String
Esempio: Mario Rossi
postCode Codice Postale.
Lunghezza massima consigliata: 16 caratteri.
 String
Esempio: 40124
province Codice della provincia.
Lunghezza massima consigliata: 3 caratteri.
 String
Esempio: BO
street Indirizzo completo.
Lunghezza massima consigliata: 50 caratteri.
 String
Esempio: Piazza Maggiore, 1
cardHolderAcctInfo Oggetto contenente informazioni sull'account dell'acquirente.
 Object
chAccAgeIndicator Indicatore dell'età dell'account sul sito del commerciante:
01 = Nessun conto
02 = Creato durante questa transazione
03 = Creato negli ultimi 30 giorni
04 = Creato tra 30 e 60 giorni fa
05 = Creato prima di 60 giorni fa
 String
Esempio: 01
chAccChangeDate Data dell'ultima variazione dell'account sul sito web del commerciante, incluso indirizzo di fatturazione o spedizione, nuovo account di pagamento o nuovi utenti aggiunti.
 String
Esempio: 2019-02-11T00:00:00.000+0000
chAccChangeIndicator Tempo trascorso dall'ultima modifica alle informazioni dell'account dell'acquirente sul sito del commerciante, incluso l'indirizzo di fatturazione o di spedizione, il nuovo account di pagamento o l'aggiunta di nuovi utenti.
01 = Creato durante questa transazione
02 = Creato negli ultimi 30 giorni
03 = Creato tra 30 e 60 giorni fa
04 = Creato prima di 60 giorni fa
 String
Esempio: 01
chAccDate Data di attivazione dell'account sul sito web del commerciante.
 String
Esempio: 2019-02-11T00:00:00.000+0000
chAccPwChangeDate Data dell'ultima modifica della password dell'account (inclusa la reimpostazione della password).
 String
Esempio: 2019-02-11T00:00:00.000+0000
chAccPwChangeIndicator Tempo trascorso da quando l'account dell'acquirente ha eseguito una modifica della password o un ripristino dell'account:
01 = Nessun conto
02 = Creato durante questa transazione
03 = Negli ultimi 30 giorni
04 = Tra 30 e 60 giorni fa
05 = Prima di 60 giorni fa
 String
Esempio: 01
destinationAddressUsageDate Data dell'ultimo utilizzo di questo indirizzo di consegna.
 String
Esempio: 2019-02-11T00:00:00.000+0000
destinationAddressUsageIndicator Indica quando è stato utilizzato per la prima volta l'indirizzo di spedizione utilizzato per questa transazione:
01 = Creato durante questa transazione
02 = Creato negli ultimi 30 giorni
03 = Creato tra 30 e 60 giorni fa
04 = Creato prima di 60 giorni fa
 String
Esempio: 01
destinationNameIndicator Indica se il nome associato all'account corrisponde al nome indicato per la spedizione:
01 = Nome account identico al nome dell'indirizzo di spedizione.
02 = Nome account diverso dal nome dell'indirizzo di spedizione
 String
Esempio: 01
nbPurchaseAccount Numero di acquisti di questo account negli ultimi 6 mesi.
 Integer
Esempio: 0
paymentAccAgeDate Data di attivazione del conto di pagamento.
 String
Esempio: 2019-02-11T00:00:00.000+0000
paymentAccIndicator Indica quando l'acquirente ha inserito il Conto di pagamento sul sito del commerciante:
01 = Nessun conto
02 = creato durante questa transazione
03 = Creato negli ultimi 30 giorni
04 = Creato tra 30 e 60 giorni fa
05 = Creato prima di 60 giorni fa
 String
Esempio: 0
provisionAttemptsDay Numero di tentativi di aggiungere una nuova carta nelle ultime 24 ore.
 Integer
Esempio: 0
suspiciousAccActivity Indica se il commerciante ha rilevato attività sospette (incluse frodi precedenti) sul conto dell'acquirente:
01 = Nessuna attività sospetta verificata.
02 = Rilevata attività sospetta
 String
Esempio: 01
txnActivityDay Numero di transazioni (riuscite e abbandonate) per questo account nelle 24 ore precedenti.
 Integer
Esempio: 0
txnActivityYear Numero di transazioni (riuscite e abbandonate) per questo conto nell'anno precedente.
 Integer
Esempio: 0
cardHolderEmail E-mail del titolare della carta.
Lunghezza massima consigliata: 255 caratteri.
 String
Esempio: mauro.morandi@nexi.it
cardHolderName Nome e cognome del titolare della carta.
Lunghezza massima consigliata: 255 caratteri.
 String
Esempio: Mauro Morandi
homePhone Numero di telefono di casa fornito dal titolare della carta.
Lunghezza massima consigliata: 18 caratteri.
 String
Esempio: 391231234567
merchantRiskIndicator Oggetto contenente informazioni relative all'acquisto effettuato.
 Object
deliveryEmail In caso di acquisto di prodotti virtuali/digitali: indirizzo email a cui viene inviato il prodotto.
 String
Esempio: john.doe@email.com
deliveryTimeframe Indicatore sul periodo di consegna della merce:
01 = Consegna immediata (prodotti virtuali/digitali).
02 = Consegna lo stesso giorno.
03 = Consegna notturna.
04 = Consegna in due o più giorni
 String
Esempio: 01
giftCardAmount Oggetto contenente l'importo totale e la valuta delle carte prepagate o gift card acquistate.
 Object
currency Per l'acquisto di carte prepagate o regalo, il codice valuta della carta come definito nella norma ISO 4217.
EMVCO: GiftCardCurr
 String
Esempio: EUR
value Per l'acquisto di carte prepagate o regalo, l'importo totale dell'acquisto
di carte prepagate o regalo in unità principali (ad esempio, 123,45 USD è 123).
EMVCO: importo della carta regalo
 String
Lunghezza max: 18
Esempio: 100
giftCardCount Numero totale di carte/codici individuali prepagati o regalo acquistati.
 Integer
Esempio: 0
preOrderDate Per un acquisto preordinato, la data prevista in cui la merce sarà disponibile.
 String
Esempio: 2019-02-11T00:00:00.000+0000
preOrderPurchaseIndicator Indica se l'acquirente sta effettuando un ordine per merce con disponibilità futura:
01 = Merci disponibili.
02 = Disponibilità futura.
 String
Esempio: 01
reorderItemsIndicator Indica se il titolare della carta sta riordinando la merce acquistata in precedenza:
01 = Primo ordine.
02 = Merce già acquistata in precedenza.
 String
Esempio: 01
shipIndicator Indicatore sul tipo di consegna:
01 = Spedizione all'indirizzo di fatturazione.
02 = Spedizione ad un altro indirizzo verificato dal commerciante.
03 = Consegna ad un indirizzo diverso da quello di fatturazione.
04 = Spedizione o ritiro presso il negozio (nell'oggetto "destinationAddress" deve essere indicato l'indirizzo del negozio).
05 = Beni virtuali/digitali, compresi servizi online, buoni regalo elettronici, codici di recupero.
06 = Biglietti di viaggio ed eventi (non inviati).
07 = Altro: ad esempio giochi, servizi digitali non inviati, abbonamenti a media elettronici
 String
Esempio: 01
mobilePhone Telefono cellulare.
Lunghezza massima consigliata: 15 caratteri.
 String
Esempio: 3280987654
mobilePhoneCountryCode Prefisso del telefono cellulare.
Lunghezza massima consigliata: 4 caratteri.
 String
Esempio: +39
recontactConsent In alcuni scenari è possibile raccogliere il consenso del pagatore ad essere ricontattato dal commerciante. Questo campo indica se il pagatore ha dato tale consenso. Boolean
shippingAddress Oggetto contenente il dettaglio dell'indirizzo del cliente.
 Object
additionalInfo Informazioni aggiuntive sull'indirizzo, ad esempio il piano.
Lunghezza massima consigliata: 50 caratteri.
 String
Esempio: Quinto Piano, Scala B
city Città.
Lunghezza massima consigliata: 40 caratteri.
 String
Esempio: Bologna
country Stato nel codice ISO 3166-1 alpha-3.
Lunghezza massima consigliata: 3 caratteri.
 String
Esempio: ITA
name Nome e cognome.
Lunghezza massima consigliata: 50 caratteri.
 String
Esempio: Mario Rossi
postCode Codice Postale.
Lunghezza massima consigliata: 16 caratteri.
 String
Esempio: 40124
province Codice della provincia.
Lunghezza massima consigliata: 3 caratteri.
 String
Esempio: BO
street Indirizzo completo.
Lunghezza massima consigliata: 50 caratteri.
 String
Esempio: Piazza Maggiore, 1
tin Il numero di identificazione fiscale viene raccolto in determinati scenari, come le donazioni, per conformarsi alle normative fiscali. È un identificatore utilizzato in molti paesi a fini fiscali.
 String
Lunghezza max: 32
Esempio: 12345678901
workPhone Numero di telefono lavorativo fornito dal titolare della carta.
Lunghezza massima consigliata: 18 caratteri.
 String
Esempio: 391231234567
omnichannelId Identificativo omnichannel. Viene utilizzato per correlare la stessa operazione tra diversi canali.
 String
operationAmount Importo dell'operazione nella valuta del pagamento
 String
Esempio: 3545
operationCurrency Valuta di pagamento
 String
Esempio: EUR
operationId Identificativo univoco dell'operazione
 String
Esempio: 852525265182852619
operationResult Esito dell'operazione:
* AUTORIZZATO - Pagamento autorizzato
* ESEGUITO - Pagamento confermato, verifica eseguita con successo
* DECLINED - Rifiutato dall'Emittente in fase di autorizzazione
* DENIED_BY_RISK - Esito negativo dell'analisi del rischio di transazione
* THREEDS_VALIDATED - Autenticazione 3DS OK o 3DS saltata (pagamento non sicuro)
* THREEDS_FAILED - annullamento o errore di autenticazione durante 3DS
* IN ATTESA - Pagamento in corso. Sono previste notifiche di follow-up
* ANNULLATO - Annullato dal titolare della carta
* ANNULLATO - Storno online dell'intero importo autorizzato
* RIMBORSATO - Importo rimborsato totale o parziale
* FALLITO - Pagamento non riuscito per motivi tecnici
 String
Esempio: AUTHORIZED
operationTime Tempo di funzionamento in formato ISO 8601
 String
operationType Indica lo scopo della richiesta:
- AUTORIZZAZIONE - autorizzazione al pagamento.
- CAPTURE - cattura dell'importo autorizzato.
- VOID - annullamento di un'autorizzazione.
- RIMBORSO - rimborso di un importo catturato.
- ANNULLA - il rollback di una cattura, rimborso.
- CARD_VERIFICATION - verifica il funzionamento, senza alcun addebito, al solo scopo di confermare la validità dei dati della carta inseriti dal cliente.
- NOSHOW - operazione noshow (riservata al servizio Disputeless).
- INCREMENTAL - operazione incrementale (riservata al servizio Disputeless).
- DELAY_CHARGE - operazione di addebito ritardato (riservata al servizio Disputeless).
 String
Esempio: CAPTURE
orderId Identificatore dell'ordine del commerciante, univoco nel dominio del commerciante.
La lunghezza massima è di 27 caratteri. Per rispettare le specifiche del circuito di pagamento, si consiglia vivamente di utilizzare un orderId fino a 18 caratteri.
Una buona strategia di unicità è quella di combinare un commerciante stabile o un prefisso di canale con una sequenza monotona, un timestamp o un riferimento all'ordine della piattaforma, evitando il riutilizzo per pagamenti diversi.
 String
Lunghezza max: 27
Esempio: btid2384983
paymentCircuit Uno dei valori del circuito di pagamento restituiti dal servizio web GET payment_methods.
L'elenco può includere (ma non limitato a) VISA, MC, AMEX, DINERS, GOOGLE_PAY, APPLE_PAY, PAYPAL, BANCONTACT, BANCOMAT_PAY, MYBANK, PIS, AMAZON_PAY, ALIPAY.
 String
Esempio: VISA
paymentEndToEndId Identificativo definito dal circuito per identificare univocamente la transazione.
Necessario per scopi di riconciliazione del circuito.
 String
Lunghezza min: 18
Lunghezza max: 35
Esempio: e723hedsdew12345678
paymentInstrumentInfo Informazioni sullo strumento di pagamento
 String
Esempio: ***6152
paymentLinkId ID PayByLink utilizzato per correlare questa operazione con il collegamento originale.
 String
Esempio: 234244353
paymentMethod * CARD - Qualsiasi circuito di scheda
* APM - Metodo di pagamento alternativo
 String
Esempio: CARD
warnings Elenco degli avvisi relativi all'operazione.
 Array
code Codice di avviso. String
Esempio: TRA001
description Descrizione dell'avviso. String
Esempio: 3DS warning