API > GET /reservations/{reservationId}

GET/reservations/{reservationId}

PROD

https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/reservations/{reservationId}

TEST

https://xpaysandbox.nexigroup.com/api/phoenix-0.0/psp/api/v1/reservations/{reservationId}

Ricerca struttura tramite identificativo.

PARAM HEADER

NOME

DESCRIZIONE

FORMATO

		X-Api-Key	Chiave API d'autenticazione.	String Formato: uuid Esempio: 625b4884-38f8-11ed-a261-0242ac120002
		Correlation-Id	Identificatore univoco della richiesta.	String Formato: uuid Esempio: 4935e818-38e0-11ed-a261-0242ac120002

PARAM PATH

NOME

DESCRIZIONE

FORMATO

reservationId

Merchant reservation id

String
Esempio: btid2384983

PARAM QUERY

NOME

DESCRIZIONE

FORMATO

No param query

PARAM BODY

NOME

DESCRIZIONE

FORMATO

No param body

RESPONSE 200

Reservation found - Nessun header per questa risposta

BODY

NOME

DESCRIZIONE

FORMATO

reservationStatus

Oggetto contenente il dettaglio dello stato della prenotazione.

Object

reservation

Oggetto contenente il dettaglio della prenotazione.

Object

reservationId

ID prenotazione esercente, univoco nel dominio esercente.

String
Lunghezza max: 27
Esempio: btid2384983

status

Valori possibili:
- ACTIVE
- CANCELED

String
Esempio: ACTIVE

creationDate

Il timestamp relativo alla data di creazione della struttura.

String
Esempio: 2022-08-01

amount

Importo della transazione nell'unità monetaria più piccola. 50 EUR sono rappresentati come 5000 (2 decimali) 50 JPY sono rappresentati come 50 (0 decimali).

String
Esempio: 3545

currency

Valuta della transazione nel codice ISO 4217.

String
Esempio: EUR

deposit

Importo della transazione nell'unità monetaria più piccola. 50 EUR sono rappresentati come 5000 (2 decimali) 50 JPY sono rappresentati come 50 (0 decimali).

String
Esempio: 3500

description

Descrizione della transazione.

String
Lunghezza max: 255
Esempio: Prenotazione camera - Cefalù

reservationType

Valori possibili:
- PREPAID_REFUNDABLE: la prenotazione viene pagata in anticipo per il servizio che verrà fornito e può essere rimborsata.
- PREPAID_NOT_REFUNDABLE: la prenotazione è pagata in anticipo per il servizio che verrà fornito e non è rimborsabile.
- GUARANTEED_NOSHOW: prenotazione, tramite una verifica carta senza addebito al cliente. Nel caso il cliente non si presenti presso la struttura, è possibile addebitare il costo della prima notte di soggiorno.
- GUARANTEED_PENALTY: prenotazione, tramite una verifica carta senza addebito al cliente. Viene effettuato un addebito in automatico della penale prestabilita nel caso in cui un ospite non si presenti presso la struttura.
- BUNDLE: prenotazione di un pacchetto contenente più servizi erogato dalla stessa struttura ad esempio soggiorno + escursione + ristorante + bus turistico.

String
Esempio: GUARANTEED

structureId

Identificatore della struttura univoco nel dominio dell'esercente.

String
Lunghezza min: 1
Lunghezza max: 36
Esempio: 99a172e5-423c-4648-9895-4cb5d1d43134

termsAndConditionsIds

Array di identificativi dei T&C della struttura. Inserimento termini e condizioni

Array

checkInDate

Check-in in formato ISO 8601.

String
Esempio: 2022-09-01

checkInFromTime

Ora inizio check in, da intendersi come orario locale della struttura.

String
Lunghezza max: 11
Esempio: 09:00

checkInToTime

Ora fine check in, da intendersi come orario locale della struttura.

String
Lunghezza max: 11
Esempio: 20:00

checkOutDate

Orario di check out in formato ISO 8601.

String
Esempio: 2022-09-05

checkOutFromTime

Ora inizio check out, da intendersi come orario locale della struttura.

String
Lunghezza max: 11
Esempio: 09:00

checkOutToTime

Ora fine check out, da intendersi come orario locale della struttura.

String
Lunghezza max: 11
Esempio: 20:00

reservationPeriod

Numero di giorni o notti per la prenotazione.

String
Lunghezza max: 4
Esempio: 4

customerNumber

Numero di persone per la prenotazione.

String
Lunghezza max: 4
Esempio: 2

customerName

Il nome del titolare della prenotazione.

String
Lunghezza max: 255
Esempio: Mario

customerSurname

Il cognome dell'intestatario della prenotazione.

String
Lunghezza max: 255
Esempio: Rossi

linkExpirationDate

Data di scadenza per Paybylink.

String
Esempio: 2022-09-01

collectionType

Tipologia contabilizzazione:
- INSTANT: immediato
- DELAYED: differito
- INSTALLMENT: dilazionato
Incasso Differito e Dilazionato

String
Esempio: INSTANT

customerId

Identificativo cliente per questa transazione.

String
Lunghezza max: 27
Esempio: mcid97295873

customField

Descrizione aggiuntiva della transazione.

String
Lunghezza max: 255
Esempio: weekend promotion

customerTaxCode

Il codice fiscale del cliente.

String
Lunghezza max: 21
Esempio: SVTTRP95P03C478T

customerInfo

Oggetto contenente il dettaglio del cliente. Inviare il contenuto di questo oggetto aumenta il livello di sicurezza della transazione, aumentando così la probabilità che non venga richiesta l'autenticazione a due fattori nel pagamento.

Object

cardHolderName

Nome e cognome del titolare della carta.

String
Lunghezza max: 255
Esempio: Mauro Morandi

cardHolderEmail

Email del titolare della carta.

String
Lunghezza max: 255
Esempio: mauro.morandi@nexi.it

billingAddress

Oggetto contenente il dettaglio dell'indirizzo del cliente.

Object

name	Nome e cognome.	String Lunghezza max: 50 Esempio: Mario Rossi
street	Indirizzo completo.	String Lunghezza max: 50 Esempio: Piazza Maggiore, 1
additionalInfo	Informazioni aggiuntive sull'indirizzo, per esempio il piano.	String Lunghezza max: 50 Esempio: Quinto Piano, Scala B
city	Città.	String Lunghezza min: 1 Lunghezza max: 40 Esempio: Bologna
postCode	Codice postale.	String Lunghezza max: 16 Esempio: 40124
province	Codice della provincia.	String Lunghezza max: 3 Esempio: BO
country	Stato secondo il codice ISO 3166-1 alpha-3. Il parametro è obbligatorio con i seguenti metodi di pagamento alternativi: - Bancontact: valorizzare "country" con "BEL". - Giropay: valorizzare "country" con "DEU". - Multibanco: valorizzare "country" con "PRT".	String Lunghezza min: 3 Lunghezza max: 3 Esempio: ITA

shippingAddress

Oggetto contenente il dettaglio dell'indirizzo del cliente.

Object

name	Nome e cognome.	String Lunghezza max: 50 Esempio: Mario Rossi
street	Indirizzo completo.	String Lunghezza min: 1 Lunghezza max: 50 Esempio: Piazza Maggiore, 1
additionalInfo	Informazioni aggiuntive sull'indirizzo, per esempio il piano.	String Lunghezza max: 50 Esempio: Quinto Piano, Scala B
city	Città.	String Lunghezza min: 1 Lunghezza max: 40 Esempio: Bologna
postCode	Codice postale.	String Lunghezza max: 16 Esempio: 40124
province	Codice della provincia.	String Lunghezza max: 3 Esempio: BO
country	Stato secondo il codice ISO 3166-1 alpha-3.	String Lunghezza min: 3 Lunghezza max: 3 Esempio: ITA

mobilePhoneCountryCode

Prefisso del numero di telefono.

String
Lunghezza max: 4
Esempio: +39

mobilePhone

Numero di cellulare.

String
Lunghezza max: 15
Esempio: 3280987654

homePhone

Telefono di casa fornito dal titolare carta.

String
Lunghezza max: 18
Esempio: +391231234567

workPhone

Numero di telefono lavorativo fornito dal titolare carta.

String
Lunghezza max: 18
Esempio: 391231234567

cardHolderAcctInfo

Oggetto contenente informazioni relative all'account dell'acquirente.

Object

chAccDate	Data di attivazione dell'account sul sito dell'esercente.	String Esempio: 2019-02-11
chAccAgeIndicator	Indicatore dell'anzianità dell'account sul sito dell'esercente: 01 = Nessun account 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 dell'esercente, incluso l'indirizzo di fatturazione o spedizione, nuovo metodi di pagamento o l'aggiunta di nuovi utenti.	String Esempio: 2019-02-11
chAccChangeIndicator	Tempo trascorso dall'ultima modifica delle informazioni sull'account dell'acquirente sul sito dell'esercente, incluso l'indirizzo di fatturazione o spedizione, nuovo metodo 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
chAccPwChangeDate	Data di ultimo cambio password dell'account (incluso reset password).	String Esempio: 2019-02-11
chAccPwChangeIndicator	Tempo trascorso da quando l'account dell'acquirente ha eseguito una modifica della password o il ripristino dell'account: 01 = Nessun account 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
nbPurchaseAccount	Numero di acquisti di questo account negli ultimi 6 mesi.	Number Esempio: 0
destinationAddressUsageDate	Data di ultimo utilizzo di questo indirizzo di consegna.	String Esempio: 2019-02-11
destinationAddressUsageIndicator	Indica quando l'indirizzo di spedizione utilizzato per questa transazione è stato utilizzato per la prima volta: 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 dell'account identico al nome dell'indirizzo di spedizione. 02 = Nome dell'account diverso dal nome dell'indirizzo di spedizione.	String Esempio: 01
txnActivityDay	Numero di transazioni (riuscite e abbandonate) per questo account nelle 24 ore precedenti.	Number Esempio: 0
txnActivityYear	Numero di transazioni (riuscite e abbandonate) per questo account nell'anno precedente.	Number Esempio: 0
provisionAttemptsDay	Numero di tentativi di aggiunta nuova carta nelle ultime 24 ore.	Number Esempio: 0
suspiciousAccActivity	Indica se l'esercente ha rilevato attività sospette (incluse precedenti frodi) sull'account dell'acquirente. 01 = Nessun attività sospetta verificata. 02 = Rilevate attività sospette.	String Esempio: 01
paymentAccAgeDate	Data di attivazione dell'account di pagamento.	String Esempio: 2019-02-11
paymentAccIndicator	Indica quando l'acquirente ha inserito l'account di pagamento sul sito del merchant: 0 = Nessun account 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: 0

merchantRiskIndicator

Oggetto contenente informazioni relative all'acquisto effettuato.

Object

deliveryEmail

Nel caso di acquisto di prodotti virtuali/digitali: indirizzo mail verso 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 nello stesso giorno.
03 = Consegna notturna.
04 = Consegna in due o più giorni.

String
Esempio: 01

giftCardAmount

Oggetto contenente informazioni relative all'importo delle carte regalo o buoni.

Object

		value	Valore della carta regalo o prepagata utilizzata per la transazione. L'importo deve essere espresso in centesimi.	Number Esempio: 100
		currency	Valuta della transazione nel codice ISO 4217.	String Esempio: EUR

giftCardCount

Totale delle singole carte/codici prepagate o regalo acquistati.

Number
Esempio: 2

preOrderDate

Per un acquisto preordinato, la data prevista in cui la merce sarà disponibile.

String
Esempio: 2019-02-11

preOrderPurchaseIndicator

Indica se l'acquirente sta effettuando un ordine per merce con disponibilità futura:
01 = Merce disponibile.
02 = Disponibilità futura.

String
Esempio: 01

reorderItemsIndicator

Indica se l'acquirente sta riordinando merce acquistata in precedenza:
01 = Primo ordine.
02 = Merce già acquistata in precedenza.

String
Esempio: 01

shipIndicator

Indicatore sulla tipologia di consegna:
01 = Spedizione all'indirizzo di fatturazione.
02 = Spedizione ad un altro indirizzo verificato dal merchant.
03 = Spedizione ad un indirizzo differente da quello di fatturazione.
04 = Spedizione o ritiro al negozio (l'indirizzo del negozio deve essere indicato nei campi di destinazione).
05 = Beni virtuali/digitali, inclusi servizi online, buoni regalo elettronici, codici di riscossione.
06 = Biglietti di viaggi ed eventi (non spediti).
07 = Altro: per esempio giochi, servizi digitali non spediti, abbonamenti a media elettronici.

String
Esempio: 01

installments

Array contenente il dettaglio delle dilazioni. Obbligatorio con "collectionType" valorizzato a "INSTALLMENT".

Array

date	Data rata.	String Esempio: 2022-09-01
amount	Importo rata.	String Esempio: 350
type	Valori possibili: - AUTOMATIC: le rate verranno eseguite automaticamente da XPay. - MANUAL: le rate verranno eseguite manualmente dall'esercente.	String Esempio: AUTOMATIC

transactionSummary

Array contenente il riepilogo della transazione.

Array

language

Lingua usata nel dettaglio del riepilogo della transazione, ISO 639-2.

String
Esempio: eng

summaryList

Array contenente il riepilogo della lista.

Array

		label	Etichetta del campo.	String Lunghezza max: 50 Esempio: Number of people
		value	Valore.	String Esempio: 4

CancelationDetails

Oggetto contenente i dettagli per la cancellazione della prenotazione.

Object

dataType

Tipologia data entro cui è possibile effettuare la cancellazione della prenotazione. Valori possibili:
- DATE: data
- HOUR_FROM_CHECKIN: ore dal check in
- DAY_FROM_CHECKIN: giorni dal checkin

String
Esempio: HOUR_FROM_CHECKIN

cancellationCondition

Array contenente i dettagli sulle penali delle cancellazioni.

Array

		dataTypeValue	The value of the selected data type.	String Esempio: 2
		value	The value for the penalty amount or percentage of refund.	String Esempio: 5000

authorizedAmount

Importo autorizzato.

String
Esempio: 3545

capturedAmount

Importo contabilizzato.

String
Esempio: 3545

lastOperationType

Indica la tipologia di operazione effettuata.
- AUTHORIZATION - autorizzazione del pagamento.
- CAPTURE - contabilizzazione dell'importo autorizzato.
- VOID - revoca di un'autorizzazione.
- REFUND - storno di una capture.
- CANCEL - il rollback di una capture, storno.
- CARD_VERIFICATION - operazione di verifica, senza nessun addebito, con il solo scopo di confermare la validità dei dati carta inseriti dal cliente.
- NOSHOW - operazione di noshow (riservato al servizio Incasso senza pensieri).
- INCREMENTAL - operazione di incremental (riservato al servizio Incasso senza pensieri).
- DELAY_CHARGE - operazione di delay charge (riservato al servizio Incasso senza pensieri).

String
Esempio: CAPTURE

lastOperationTime

Operation time.

String
Esempio: 2022-08-01T16:32:22.038Z

operations

Array contenente il dettaglio delle operazioni eseguite.

Array

orderId

ID ordine esercente, univoco nel dominio esercente.

String
Lunghezza max: 18
Esempio: btid2384983

operationId

ID operazione.

String
Esempio: 3470744

channel

"Indica il canale di origine:\n
* ECOMMERCE - il titolare carta ha eseguito l'operazione attraverso un canale online.
* POS - il titolare carta ha eseguito l'operazione attraverso un POS fisico.
* BACKOFFICE - l'esercente ha eseguito l'operazione. Include le operazioni tramite API e le MIT.

String
Esempio: ECOMMERCE

channelDetail

Identifica la tipologia di servizio da cui l'operazione è stata originata, può assumere i seguenti valori:
- "HOSTED_PAYMENT_PAGE": soluzione Hosted Payment Page con redirect verso pagina di cassa, operazione di no show, incremental, delay charge.
- "SERVER_TO_SERVER": soluzione server to server 3 step, XPay Build.
- "MERCHANT_INITIATED_TRANSACTION": pagamento ricorrente.
- "PAY_BY_LINK": operazione di pagamento tramite link Pay-By-Link.
- "MOTO": operazione di pagamento tramite servizio MOTO.
- "POST_PAYMENT_OPERATION": operazione di capture, storno, annullo.
- "PRE_PAYMENT_OPERATION": operazione di verifica carta.

String

operationType

String
Esempio: CAPTURE

operationResult

Esito dell'operazione:
* AUTHORIZED - Pagamento autorizzato
* EXECUTED - Pagamento confermato, verifica effettuata con successo
* DECLINED - Rifiutato dall'emittente durante la fase di autorizzazione
* DENIED_BY_RISK - Negativo esito dell'analisi di rischio della transazione
* THREEDS_VALIDATED - Autenticazione 3DS OK oppure 3DS saltata (pagamento non sicuro)
* THREEDS_FAILED - Cancellazione oppure autenticazione fallita durante il 3DS
* PENDING - Pagamento in corso. Sono previste notifiche
* CANCELED - Cancellato dal titolare carta
* VOIDED - Storno online dell'intero importo autorizzato
* REFUNDED - Importo intero o parziale rimborsato
* FAILED - Pagamento fallito per ragioni tecniche

String
Esempio: AUTHORIZED

operationTime

Data e ora dell'operazione.

String
Esempio: 2022-09-01T01:20:00.001Z

paymentMethod

* CARD - Qualsiasi circuito di carte
* APM - Metodo di pagamento alternativo

String
Esempio: CARD

paymentCircuit

Uno dei circuiti di pagamento ritornati dalla chiamata GET payment_methods web service VISA, MC, AMEX, DINERS, GOOGLE_PAY, APPLE_PAY, PAYPAL, BANCONTACT, BANCOMAT_PAY, MYBANK, PIS, AMAZON_PAY, ALIPAY ecc.

String
Esempio: VISA

paymentInstrumentInfo

Informazioni sullo strumento di pagamento.

String
Esempio: ***6152

paymentEndToEndId

È definito dal circuito per identificare in modo univoco la transazione. Richiesto per scopi di riconciliazione circuita.

String
Lunghezza max: 35
Esempio: e723hedsdew

cancelledOperationId

ID operazione da annullare.

String
Esempio: 321312

operationAmount

Importo dell'operazione nella valuta di pagamento.

String
Esempio: 3545

operationCurrency

Valuta della transazione nel codice ISO 4217.

String
Esempio: EUR

customerInfo

Object

cardHolderName

Nome e cognome del titolare della carta.

String
Lunghezza max: 255
Esempio: Mauro Morandi

cardHolderEmail

Email del titolare della carta.

String
Lunghezza max: 255
Esempio: mauro.morandi@nexi.it

billingAddress

Oggetto contenente il dettaglio dell'indirizzo del cliente.

Object

name	Nome e cognome.	String Lunghezza max: 50 Esempio: Mario Rossi
street	Indirizzo completo.	String Lunghezza max: 50 Esempio: Piazza Maggiore, 1
additionalInfo	Informazioni aggiuntive sull'indirizzo, per esempio il piano.	String Lunghezza max: 50 Esempio: Quinto Piano, Scala B
city	Città.	String Lunghezza min: 1 Lunghezza max: 40 Esempio: Bologna
postCode	Codice postale.	String Lunghezza max: 16 Esempio: 40124
province	Codice della provincia.	String Lunghezza max: 3 Esempio: BO
country	Stato secondo il codice ISO 3166-1 alpha-3. Il parametro è obbligatorio con i seguenti metodi di pagamento alternativi: - Bancontact: valorizzare "country" con "BEL". - Giropay: valorizzare "country" con "DEU". - Multibanco: valorizzare "country" con "PRT".	String Lunghezza min: 3 Lunghezza max: 3 Esempio: ITA

shippingAddress

Oggetto contenente il dettaglio dell'indirizzo del cliente.

Object

name	Nome e cognome.	String Lunghezza max: 50 Esempio: Mario Rossi
street	Indirizzo completo.	String Lunghezza min: 1 Lunghezza max: 50 Esempio: Piazza Maggiore, 1
additionalInfo	Informazioni aggiuntive sull'indirizzo, per esempio il piano.	String Lunghezza max: 50 Esempio: Quinto Piano, Scala B
city	Città.	String Lunghezza min: 1 Lunghezza max: 40 Esempio: Bologna
postCode	Codice postale.	String Lunghezza max: 16 Esempio: 40124
province	Codice della provincia.	String Lunghezza max: 3 Esempio: BO
country	Stato secondo il codice ISO 3166-1 alpha-3.	String Lunghezza min: 3 Lunghezza max: 3 Esempio: ITA

mobilePhoneCountryCode

Prefisso del numero di telefono.

String
Lunghezza max: 4
Esempio: +39

mobilePhone

Numero di cellulare.

String
Lunghezza max: 15
Esempio: 3280987654

homePhone

Telefono di casa fornito dal titolare carta.

String
Lunghezza max: 18
Esempio: +391231234567

workPhone

Numero di telefono lavorativo fornito dal titolare carta.

String
Lunghezza max: 18
Esempio: 391231234567

cardHolderAcctInfo

Oggetto contenente informazioni relative all'account dell'acquirente.

Object

chAccDate	Data di attivazione dell'account sul sito dell'esercente.	String Esempio: 2019-02-11
chAccAgeIndicator	Indicatore dell'anzianità dell'account sul sito dell'esercente: 01 = Nessun account 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 dell'esercente, incluso l'indirizzo di fatturazione o spedizione, nuovo metodi di pagamento o l'aggiunta di nuovi utenti.	String Esempio: 2019-02-11
chAccChangeIndicator	Tempo trascorso dall'ultima modifica delle informazioni sull'account dell'acquirente sul sito dell'esercente, incluso l'indirizzo di fatturazione o spedizione, nuovo metodo 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
chAccPwChangeDate	Data di ultimo cambio password dell'account (incluso reset password).	String Esempio: 2019-02-11
chAccPwChangeIndicator	Tempo trascorso da quando l'account dell'acquirente ha eseguito una modifica della password o il ripristino dell'account: 01 = Nessun account 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
nbPurchaseAccount	Numero di acquisti di questo account negli ultimi 6 mesi.	Number Esempio: 0
destinationAddressUsageDate	Data di ultimo utilizzo di questo indirizzo di consegna.	String Esempio: 2019-02-11
destinationAddressUsageIndicator	Indica quando l'indirizzo di spedizione utilizzato per questa transazione è stato utilizzato per la prima volta: 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 dell'account identico al nome dell'indirizzo di spedizione. 02 = Nome dell'account diverso dal nome dell'indirizzo di spedizione.	String Esempio: 01
txnActivityDay	Numero di transazioni (riuscite e abbandonate) per questo account nelle 24 ore precedenti.	Number Esempio: 0
txnActivityYear	Numero di transazioni (riuscite e abbandonate) per questo account nell'anno precedente.	Number Esempio: 0
provisionAttemptsDay	Numero di tentativi di aggiunta nuova carta nelle ultime 24 ore.	Number Esempio: 0
suspiciousAccActivity	Indica se l'esercente ha rilevato attività sospette (incluse precedenti frodi) sull'account dell'acquirente. 01 = Nessun attività sospetta verificata. 02 = Rilevate attività sospette.	String Esempio: 01
paymentAccAgeDate	Data di attivazione dell'account di pagamento.	String Esempio: 2019-02-11
paymentAccIndicator	Indica quando l'acquirente ha inserito l'account di pagamento sul sito del merchant: 0 = Nessun account 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: 0

merchantRiskIndicator

Oggetto contenente informazioni relative all'acquisto effettuato.

Object

deliveryEmail

Nel caso di acquisto di prodotti virtuali/digitali: indirizzo mail verso 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 nello stesso giorno.
03 = Consegna notturna.
04 = Consegna in due o più giorni.

String
Esempio: 01

giftCardAmount

Oggetto contenente informazioni relative all'importo delle carte regalo o buoni.

Object

		value	Valore della carta regalo o prepagata utilizzata per la transazione. L'importo deve essere espresso in centesimi.	Number Esempio: 100
		currency	Valuta della transazione nel codice ISO 4217.	String Esempio: EUR

giftCardCount

Totale delle singole carte/codici prepagate o regalo acquistati.

Number
Esempio: 2

preOrderDate

Per un acquisto preordinato, la data prevista in cui la merce sarà disponibile.

String
Esempio: 2019-02-11

preOrderPurchaseIndicator

Indica se l'acquirente sta effettuando un ordine per merce con disponibilità futura:
01 = Merce disponibile.
02 = Disponibilità futura.

String
Esempio: 01

reorderItemsIndicator

Indica se l'acquirente sta riordinando merce acquistata in precedenza:
01 = Primo ordine.
02 = Merce già acquistata in precedenza.

String
Esempio: 01

shipIndicator

String
Esempio: 01

warnings

Array contenente la lista di warning.

Array

		code	Codice warning.	String Esempio: TRA001
		description	Descrizione warning.	String Esempio: 3DS warning

paymentLinkId

ID PayByLink utilizzato per correlare questa operazione con il collegamento originale.

String
Esempio: 234244353

additionalData

Mappa dei campi aggiuntivi specifici per il metodo di pagamento selezionato.

È consigliato non introdurre vincoli sull’oggetto "additionalData", poiché attività di manutenzione e potenziamento potrebbero comportare modifiche ai suoi parametri.

Object
Esempio: {"authorizationCode":"647189","cardCountry":"ITA","threeDS":"FULL_SECURE","schemaTID":"MCS01198U","multiCurrencyConversion":{"amount":"2662","currency":"JPY","exchangeRate":"0.007510523"}}

paymentLinks

Array contenente la lista di link di pagamento.

Array

linkId	Identificatore univoco per questo link.	String Esempio: 92864835
amount	Importo della transazione nell'unità monetaria più piccola. 50 EUR sono rappresentati come 5000 (2 decimali) 50 JPY sono rappresentati come 50 (0 decimali).	String Esempio: 3545
expirationDate	Data di scadenza.	String Esempio: 2022-09-01
link	Link da condividere con il cliente per effettuare il pagamento.	String Esempio: https://{gateway_hosted_page}
paidByOperationId	ID operazione che identifica il pagamento andato a buon fine relativo a questo link.	String Esempio: 3470744

RESPONSE 404

Not found - Nessun header e body per questa risposta

RESPONSE 401

Unauthorized - Nessun header e body per questa risposta

RESPONSE 500

Internal Server Error - Nessun header per questa risposta

BODY

NOME

DESCRIZIONE

FORMATO

errors

Array contenente la lista degli errori. I valori possibili sono riportati nella tabella Codici errore.

Array

		code	Codice errore.	String Esempio: GW0001
		description	Descrizione errore.	String Esempio: Invalid merchant URL