Recuperare un Gateway
July 30, 2026
Recupera un Gateway FlowAlp Pay per ID e controlla lo stato del pagamento (waiting, confirmed, authorized, reserved). Esempi curl e SDK PHP.
Recuperare un Gateway legge lo stato attuale di un singolo Gateway a partire dal suo ID. Usalo per controllare se un checkout è stato pagato — ad esempio per verificare un webhook ricevuto — o per rileggere link di pagamento e configurazione.
https://api.pay.flowalp.com/v1.16/Gateway/{id}/v1.14 · v1.15 · v1.16Per le nuove integrazioni usa la versione API v1.16; v1.14 e v1.15 restano supportate. Autenticati con l'header X-API-KEY — vedi Autenticazione.
Request
Path parameter
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| id | integer | Sì | ID del Gateway da recuperare, come restituito al momento della creazione. |
Query parameter
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| instance | string | Sì | Nome della tua instance; identifica il tuo account a ogni chiamata API. |
Esempio di request
curl --request GET \
--url "https://api.pay.flowalp.com/v1.16/Gateway/42/?instance=${FLOWALP_PAY_INSTANCE}" \
--header "X-API-KEY: ${FLOWALP_PAY_API_SECRET}"<?php
use FlowAlpPay\FlowAlpPay;
use FlowAlpPay\Models\Request\Gateway;
$client = new FlowAlpPay(
getenv('FLOWALP_PAY_INSTANCE'),
getenv('FLOWALP_PAY_API_SECRET'),
FlowAlpPay::DEFAULT_COMMUNICATION_HANDLER,
'pay.flowalp.com',
'1.16'
);
$gateway = new Gateway();
$gateway->setId(42);
$response = $client->getOne($gateway);
// waiting, confirmed, authorized or reserved
$status = $response->getStatus();Response
Il Gateway viene restituito nell'envelope standard di successo. Il campo status indica a che punto è il pagamento.
{
"status": "success",
"data": [
{
"id": 42,
"status": "confirmed",
"hash": "cb1a4e6ad0714b8c93cbfe6a6e2489d5",
"referenceId": "ORDER-2026-001",
"link": "https://demo-shop.pay.flowalp.com/?payment=cb1a4e6ad0714b8c93cbfe6a6e2489d5",
"amount": 8925,
"currency": "CHF",
"preAuthorization": false,
"reservation": false,
"createdAt": "2026-07-30 11:52:08"
}
]
}Valori dello status di pagamento
| Valore | Significato | Passo successivo tipico |
|---|---|---|
| waiting | Nessun pagamento completato; il cliente non ha (ancora) concluso il checkout con successo. | Attendi o lascia scadere il Gateway; la conferma arriva via webhook. |
| confirmed | Il pagamento è stato completato e l'importo è stato addebitato. | Evadi l'ordine e riconcilialo usando referenceId. |
| authorized | Il metodo di pagamento è stato autorizzato o memorizzato, ma nessun importo è stato ancora addebitato. | Addebita più tardi il metodo memorizzato tramite l'API Transactions. |
| reserved | L'importo è riservato sul metodo di pagamento del cliente. | Esegui il capture della reservation per incassare l'importo. |
Preferisci i webhook al polling di questo endpoint: FlowAlp Pay avvisa il tuo server non appena lo stato del pagamento cambia, e a quel punto puoi chiamare Recuperare un Gateway per verificare la notifica rispetto all'API prima di aggiornare l'ordine. Per addebitare o catturare pagamenti authorized e reserved usa l'API Transactions.
Errori
| Status HTTP | Significato | Azione consigliata |
|---|---|---|
| 404 | Sulla tua instance non esiste alcun Gateway con questo ID. | Controlla l'ID del Gateway salvato e il parametro instance. |
Le response di errore usano l'envelope {"status": "error", "message": "..."} — vedi Errori e Rate limit.
Correlati: crea i checkout con Creare un Gateway, elimina quelli inutilizzati con Eliminare un Gateway e imposta le notifiche in Configurare i webhook.