Accesso tramite Payments API

A partire dalla versione 1.2.0, le API dei proxy di pagamento non verrano più chiamate singolarmente per gestire le configurazioni di tenant e servizio. Tutte le chiamate passeranno attraverso le API Payments qui documentate, che funge da punto di accesso unico e instrada le richieste verso il proxy corretto.

Come funziona

Per ogni richiesta di configurazione, il servizio:

1. Riceve la chiamata dal consumer su /payment-gateways/{gateway}/...
2. Risolve il gateway in base alla configurazione (PAYMENT_GATEWAYS)
3. Costruisce l'URL del proxy: {PAYMENT_PROXY_BASE_URL}/{gateway}/{versione}
4. Inoltra la richiesta (metodo HTTP, body, header Authorization se presente)
5. Restituisce la risposta del proxy invariata — status code e body as-is

Il comportamento delle API di tenant e configurazione non cambia: schema dei campi, metodi HTTP e risposte sono quelli definiti in API v2. Cambia solo il punto di ingresso.

Endpoint disponibili

Gateway

Metodo	Path	Descrizione
GET	/payment-gateways	Lista dei gateway configurati

Tenant

Metodo	Path	Descrizione
GET	/payment-gateways/{gateway}/tenants/schema	Schema dei campi per la configurazione tenant
POST	/payment-gateways/{gateway}/tenants	Crea una nuova configurazione tenant
GET	/payment-gateways/{gateway}/tenants/{id}	Legge una configurazione tenant
PUT	/payment-gateways/{gateway}/tenants/{id}	Aggiorna una configurazione tenant
PATCH	/payment-gateways/{gateway}/tenants/{id}	Aggiornamento parziale
DELETE	/payment-gateways/{gateway}/tenants/{id}	Disattiva una configurazione tenant

Configurazione pagamento

Metodo	Path	Descrizione
GET	/payment-gateways/{gateway}/configs/schema	Schema dei campi per la configurazione pagamento
POST	/payment-gateways/{gateway}/configs	Crea una nuova configurazione
GET	/payment-gateways/{gateway}/configs/{id}	Legge una configurazione
PUT	/payment-gateways/{gateway}/configs/{id}	Aggiorna una configurazione
PATCH	/payment-gateways/{gateway}/configs/{id}	Aggiornamento parziale
DELETE	/payment-gateways/{gateway}/configs/{id}	Disattiva una configurazione

Risposte di errore

Status	Quando
404 application/problem+json	Il gateway non è tra quelli in PAYMENT_GATEWAYS
502 application/problem+json	Il payment-proxy downstream non è raggiungibile

Gli errori restituiti dal proxy downstream (es. 400, 422) vengono inoltrati al chiamante così come sono.

Autenticazione

L'header Authorization viene inoltrato al proxy downstream se presente. La sua assenza non genera un errore 401.