FlowAlp

Delete a Gateway

July 30, 2026

Delete a FlowAlp Pay Gateway by ID with the Merchant API: DELETE /Gateway/{id}/ request, curl and PHP SDK examples, response and errors.

Delete a Gateway removes a Gateway by its ID so that its checkout link can no longer be used. A typical use case is cleaning up Gateways that were created but never paid, for example after a customer abandoned the order.

DELETEhttps://api.pay.flowalp.com/v1.16/Gateway/{id}/v1.14 · v1.15 · v1.16

Use API version v1.16 for new integrations; v1.14 and v1.15 remain supported. Authenticate with the X-API-KEY header — see Authentication.

Request

Path parameters

ParameterTypeRequiredDescription
idintegerYesID of the Gateway to delete.

Query parameters

ParameterTypeRequiredDescription
instancestringYesName of your merchant instance; identifies your account on every API call.

Example request

Delete a Gateway (cURL)bash
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}"
Delete a Gateway (PHP SDK)PHP
<?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

A successful call returns HTTP 200 with the success envelope confirming the deleted Gateway.

200 OKJSON
{
  "status": "success",
  "data": [
    {
      "id": 42
    }
  ]
}

Deletion is permanent and cannot be undone. If you only want to inspect a Gateway or check its payment state, use Retrieve a Gateway instead.

Errors

HTTP statusMeaningRecommended action
400The request is invalid, for example the ID is malformed.Fix the request and try again.
404No Gateway with this ID exists on your instance.Check the Gateway ID and the instance parameter.

Error responses use the envelope {"status": "error", "message": "..."} — see Errors and Rate limits.

Related: Create a Gateway, Retrieve a Gateway and the end-to-end guide Accept a one-time payment.