FlowAlp

Instance-Name

July 30, 2026

Was der Instance-Name in FlowAlp Pay ist, wo er in der Domain Ihrer Zahlungsseite erscheint und wie Sie ihn in jeder Merchant-API-Anfrage übergeben.

Die Instance — auch Tenant-Name genannt — ist der technische Identifier Ihres Händlerkontos in FlowAlp Pay. Sie erscheint in der Domain Ihrer Zahlungsseiten und muss bei jeder Merchant-API-Anfrage als Query-Parameter instance mitgesendet werden.

Wo die Instance auftaucht

Eine Instance, zwei Ortetext
Instance:      demo-shop
Tenant URL:    https://demo-shop.pay.flowalp.com
API request:   https://api.pay.flowalp.com/v1.16/SignatureCheck/?instance=demo-shop

Die allgemeine Form Ihrer Tenant-Domain ist https://<instance>.pay.flowalp.com. Über sie melden Sie sich im Dashboard an, und Ihre gehosteten Zahlungsseiten werden unter ihr ausgeliefert.

Instance und andere Identifier

Verwechseln Sie die Instance nicht mit anderen Identifiern, die Ihnen in der Dokumentation begegnen:

IdentifierWas er identifiziert
Instance-NameIhr Händlerkonto (dieser Artikel).
API SecretDie Zugangsdaten, die Ihre API-Anfragen authentifizieren — niemals weitergeben.
Gateway-IDEine über die API erstellte Checkout-Session.
Transaction-IDEine einzelne Zahlungstransaktion.
referenceIdIhre eigene Bestellnummer, die Sie beim Erstellen einer Zahlung übergeben.
FlowAlp Organization IDIhre Organisation im FlowAlp Dashboard, ausserhalb von FlowAlp Pay.

Die Instance in der Merchant API verwenden

Jede Anfrage führt die Instance als Query-Parameter mit:

Muster der Basis-URLtext
https://api.pay.flowalp.com/v1.16/:object/:id?instance=<instance>
TeilBeschreibung
:objectDie Ressource, zum Beispiel Gateway, Transaction oder Subscription.
:idDie Entitäts-ID, verwendet bei GET, PUT und DELETE auf einer einzelnen Entität.
instanceIhr Instance-Name — immer in der Query-String.

Bei POST-Anfragen gehören alle übrigen Parameter in den Request-Body; nur instance bleibt in der Query-String. Details: Merchant API im Überblick und Authentifizierung.

Einrichtung prüfen

Kombinieren Sie Ihre Instance mit einem API Secret (siehe API-Zugangsdaten) und prüfen Sie das Paar mit SignatureCheck:

Instance und API Secret prüfenbash
curl --request GET \
  --url "https://api.pay.flowalp.com/v1.16/SignatureCheck/?instance=demo-shop" \
  --header "x-api-key: <api-secret>"

Eine Antwort mit HTTP-Status 200 und einem Erfolgsstatus bestätigt, dass Instance und API Secret gültig sind.

Sicherheitshinweise

  • Der Instance-Name ist in URLs sichtbar und für sich genommen kein Geheimnis — geben Sie ihn aber nie zusammen mit dem API Secret im Frontend-Code preis.
  • Anfragen mit gültiger Instance, aber fehlendem oder falschem API Secret werden abgelehnt.
  • Sie dürfen den Instance-Namen protokollieren; protokollieren Sie niemals das API Secret.

Instance gefunden? Erstellen Sie als Nächstes Ihre API-Zugangsdaten und senden Sie dann Ihre erste API-Anfrage.