Eliminare un Gateway
July 30, 2026
Elimina un Gateway FlowAlp Pay per ID con la Merchant API: request DELETE /Gateway/{id}/, esempi curl e SDK PHP, response ed errori.
Eliminare un Gateway rimuove un Gateway a partire dal suo ID, così il suo link di checkout non può più essere usato. Un caso d'uso tipico è la pulizia dei Gateway creati ma mai pagati, ad esempio dopo che un cliente ha abbandonato l'ordine.
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 eliminare. |
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 DELETE \
--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);
$client->delete($gateway);Response
Una chiamata riuscita restituisce HTTP 200 con l'envelope di successo che conferma il Gateway eliminato.
{
"status": "success",
"data": [
{
"id": 42
}
]
}L'eliminazione è definitiva e non può essere annullata. Se vuoi solo esaminare un Gateway o controllarne lo stato di pagamento, usa invece Recuperare un Gateway.
Errori
| Status HTTP | Significato | Azione consigliata |
|---|---|---|
| 400 | La request non è valida, ad esempio l'ID è malformato. | Correggi la request e riprova. |
| 404 | Sulla tua instance non esiste alcun Gateway con questo ID. | Controlla l'ID del Gateway e il parametro instance. |
Le response di errore usano l'envelope {"status": "error", "message": "..."} — vedi Errori e Rate limit.
Correlati: Creare un Gateway, Recuperare un Gateway e la guida completa Accettare un pagamento singolo.