FlowAlp

Gateway abrufen

July 30, 2026

Gateway per ID über die FlowAlp Pay Merchant API abrufen und den Zahlungsstatus prüfen: waiting, confirmed, authorized oder reserved.

Gateway abrufen liest den aktuellen Zustand eines einzelnen Gateways anhand seiner ID. Damit prüfen Sie, ob ein Checkout bezahlt wurde — zum Beispiel um einen empfangenen Webhook gegenzuprüfen — oder schlagen Zahlungslink und Konfiguration erneut nach.

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

Verwenden Sie für neue Integrationen die API-Version v1.16; v1.14 und v1.15 werden weiterhin unterstützt. Authentifizieren Sie sich mit dem Header X-API-KEY — siehe Authentifizierung.

Request

Path-Parameter

ParameterTypPflichtBeschreibung
idintegerJaID des abzurufenden Gateways, wie bei der Erstellung zurückgegeben.

Query-Parameter

ParameterTypPflichtBeschreibung
instancestringJaName Ihrer Händler-Instance; identifiziert Ihr Konto bei jedem API-Aufruf.

Beispiel-Request

Gateway abrufen (cURL)bash
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}"
Gateway abrufen (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);

$response = $client->getOne($gateway);

// waiting, confirmed, authorized or reserved
$status = $response->getStatus();

Response

Das Gateway wird im Standard-Erfolgs-Envelope zurückgegeben. Das Feld status zeigt, wo die Zahlung steht.

200 OKJSON
{
  "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"
    }
  ]
}

Werte des Zahlungsstatus

WertBedeutungTypischer nächster Schritt
waitingNoch keine abgeschlossene Zahlung; der Kunde hat den Checkout nicht (erfolgreich) beendet.Warten Sie oder lassen Sie das Gateway ablaufen; die Bestätigung kommt per Webhook.
confirmedDie Zahlung wurde abgeschlossen und der Betrag belastet.Wickeln Sie die Bestellung ab und gleichen Sie sie über referenceId ab.
authorizedDas Zahlungsmittel wurde autorisiert bzw. hinterlegt, aber noch kein Betrag belastet.Belasten Sie das hinterlegte Zahlungsmittel später über die Transactions-API.
reservedDer Betrag ist auf dem Zahlungsmittel des Kunden reserviert.Führen Sie ein Capture aus, um den Betrag einzuziehen.

Bevorzugen Sie Webhooks statt Polling auf diesem Endpoint: FlowAlp Pay benachrichtigt Ihren Server, sobald sich der Zahlungsstatus ändert; anschliessend können Sie mit Gateway abrufen die Benachrichtigung gegen die API verifizieren, bevor Sie die Bestellung aktualisieren. Zum Belasten oder Capturen von Zahlungen mit Status authorized oder reserved verwenden Sie die Transactions-API.

Fehler

HTTP-StatusBedeutungEmpfohlene Massnahme
404Auf Ihrer Instance existiert kein Gateway mit dieser ID.Prüfen Sie die gespeicherte Gateway-ID und den Parameter instance.

Fehler-Responses verwenden den Envelope {"status": "error", "message": "..."} — siehe Fehler und Rate limits.

Verwandt: Erstellen Sie Checkouts mit Gateway erstellen, entfernen Sie ungenutzte mit Gateway löschen und richten Sie Benachrichtigungen unter Webhooks konfigurieren ein.