Nessun risultato trovato

POST/reservations/{reservationId}/paybylink

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

Genera PayByLink per una specifica prenotazione. In caso del primo pagamento per la prenotazione, viene creato un contractId. In caso di pagamenti successivi viene utilizzato il contractId della prenotazione esistente. Il contractId viene creato automaticamente dall'API, da utilizzare successivamente per eventuali noshow o incrementali; non è necessario inviare un oggetto specifico per la sua creazione. Il contractId non viene restituito nella risposta API, pertanto non può essere utilizzato per eseguire operazioni MIT.

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
language Lingua String
x-user x-user String
X-Api-Key Chiave API di autenticazione. String
Formato: uuid
Esempio: 625b4884-38f8-11ed-a261-0242ac120002
PARAM PATH
NOME DESCRIZIONE FORMATO
reservationId ID prenotazione String
PARAM QUERY
NOME DESCRIZIONE FORMATO
No param query
PARAM BODY

request

NOME DESCRIZIONE FORMATO
captureType Sovrascrive il metodo di conferma predefinito del terminale, solo per i pagamenti con carta:
* IMPLICIT - conferma automatica
* EXPLICIT - solo autorizzazione

Il valore predefinito dipende dalla configurazione del terminale.
1. Terminale impostato su EXPLICIT:
a. se captureType è EXPLICIT la cattura sarà EXPLICIT
b. se captureType è nullo la cattura sarà EXPLICIT
c. se captureType è IMPLICIT la cattura sarà IMPLICIT

2. Terminale impostato su IMPLICIT:
a. se captureType è EXPLICIT l'acquisizione sarà un errore
b. se captureType è nullo la cattura sarà IMPLICIT
c. se captureType è IMPLICIT la cattura sarà IMPLICIT
 String
Esempio: EXPLICIT
linkExpirationDate String
Arrow RESPONSE 200
Successo - Nessun header per questa risposta
BODY
NOME DESCRIZIONE FORMATO
paymentLink Oggetto contenente i dettagli del link Pay-By-Link.
 Object
amount Importo della transazione nell'unità monetaria più piccola. 5000 corrisponde a 50,00 €. Espresso nella valuta del pagamento.
 String
expirationDate Data di scadenza del collegamento Pay-By-Link.
 String
link URL di pagamento per Pay-By-Link.
 String
linkId Identificatore del collegamento Pay-By-Link.
 String
paidByOperationId Identificativo dell'operazione associata al pagamento tramite collegamento Pay-By-Link.
 String
status Stato del collegamento Pay-By-Link, valori possibili:
- ATTIVO
- CANCELLATO
- SCADUTO
- INATTIVO
 String
securityToken Token di sicurezza utilizzato dal commerciante per convalidare la fonte of the notification. String
Esempio: f3b2c1d4e5a6b7c8d9e0f1a2b3c4d5e6
warnings Array
code Codice di avviso. String
Esempio: TRA001
description Descrizione dell'avviso. String
Esempio: 3DS warning
Arrow RESPONSE 201
Creato - Nessun header e body per questa risposta
Arrow RESPONSE 401
Non autorizzato - Nessun header e body per questa risposta
Arrow RESPONSE 403
Vietato - Nessun header e body per questa risposta
Arrow RESPONSE 404
Non trovato - Nessun header e body per questa risposta