Zahlungsanbieter und Methoden-Identifier
July 30, 2026
Zahlungsanbieter Ihres FlowAlp Pay Kontos per API abfragen und alle Identifier der Zahlungsmethoden wie TWINT oder Visa nachschlagen.
Dieser Endpoint beantwortet zwei wiederkehrende Integrationsfragen: welche Zahlungsanbieter auf Ihrem FlowAlp Pay Konto konfiguriert sind und welche Zahlungsmethoden Ihre Kunden tatsächlich nutzen können. Er liefert ausserdem die numerischen Anbieter-IDs, die andere Endpoints im Parameter psp erwarten — zum Beispiel beim Erstellen einer Subscription.
Zahlungsanbieter auflisten
https://api.pay.flowalp.com/v1.16/PaymentProvider/v1.14 · v1.15 · v1.16| Parameter | Typ | Beschreibung |
|---|---|---|
| instance | string (erforderlich) | Query-Parameter: Name Ihrer Instance (Tenant). |
curl "https://api.pay.flowalp.com/v1.16/PaymentProvider/?instance=<tenant>" \
-H "x-api-key: <api-secret>"<?php
use FlowAlpPay\FlowAlpPay;
use FlowAlpPay\Models\Request\PaymentProvider;
$client = new FlowAlpPay(
getenv('FLOWALP_TENANT'),
getenv('FLOWALP_API_SECRET'),
FlowAlpPay::DEFAULT_COMMUNICATION_HANDLER,
'pay.flowalp.com',
'1.16'
);
try {
$providers = $client->getAll(new PaymentProvider());
foreach ($providers as $provider) {
echo $provider->getId() . ': ' . $provider->getName() . PHP_EOL;
}
} catch (Exception $e) {
error_log('Provider list failed: ' . $e->getMessage());
}Response
| Feld | Typ | Beschreibung |
|---|---|---|
| id | integer | Numerische ID des Anbieters. Verwenden Sie diesen Wert überall dort, wo die API einen psp-Parameter erwartet. |
| name | string | Anzeigename des Anbieters, wie auf Ihrem Konto konfiguriert. |
| availableBalance | array | null | Bei Anbietern mit einsehbarem Guthaben: eine Liste von currency/amount-Einträgen. Andernfalls null. |
| paymentMethods | array | Alle Zahlungsmethoden-Codes, die der Anbieter unterstützt. |
| activePaymentMethods | array | Die aktuell auf Ihrem Konto aktivierten Zahlungsmethoden dieses Anbieters. |
Methoden-Codes können in dieser Response in der Underscore-Schreibweise erscheinen, zum Beispiel american_express, apple_pay oder postfinance_card.
{
"status": "success",
"data": [
{
"id": 17,
"name": "TWINT",
"availableBalance": null,
"paymentMethods": ["twint"],
"activePaymentMethods": ["twint"]
},
{
"id": 15,
"name": "Invoice",
"availableBalance": null,
"paymentMethods": ["invoice"],
"activePaymentMethods": ["invoice"]
},
{
"id": 26,
"name": "Card acquiring",
"availableBalance": [
{ "currency": "CHF", "amount": "120.77" }
],
"paymentMethods": ["mastercard", "visa", "american_express", "apple_pay"],
"activePaymentMethods": ["mastercard", "visa"]
}
]
}Identifier der Zahlungsmethoden
Im übrigen API-Umfang — etwa im Parameter pm eines Gateways, mit dem Sie Zahlungsmethoden vorauswählen und den Auswahlschritt überspringen können — werden Zahlungsmethoden über die folgenden Identifier mit Bindestrich angesprochen.
| Identifier | Zahlungsmethode |
|---|---|
| alipay | Alipay |
| amazon-pay | Amazon Pay |
| american-express | American Express |
| apple-pay | Apple Pay |
| bancontact | Bancontact |
| bank-transfer | Banküberweisung |
| cartes-bancaires | Cartes Bancaires |
| crypto | Kryptowährungen |
| diners-club | Diners Club |
| discover | Discover |
| eps | EPS |
| giropay | giropay |
| google-pay | Google Pay |
| ideal | iDEAL |
| invoice | Kauf auf Rechnung |
| jcb | JCB |
| maestro | Maestro |
| mastercard | Mastercard |
| pay-by-bank | Pay by Bank |
| paypal | PayPal |
| post-finance-pay | PostFinance Pay |
| powerpay | POWERPAY |
| prepayment | Vorauskasse |
| samsung-pay | Samsung Pay |
| sepa-direct-debit | SEPA-Lastschrift |
| klarna | Klarna |
| twint | TWINT |
| unionpay | UnionPay |
| verd-cash | Verd Cash |
| visa | Visa |
| v-pay | V PAY |
| wechat-pay | WeChat Pay |
| swisscom-pay | Swisscom Pay |
Welche Methoden Ihre Kunden tatsächlich sehen, hängt von Ihrer Kontokonfiguration ab: Eine Methode wird nur angeboten, wenn ein Anbieter, der sie unterstützt, für Ihr Konto aktiviert ist. Fragen Sie activePaymentMethods ab, statt Annahmen fest zu verdrahten.
Fehler
| HTTP-Status | Bedeutung |
|---|---|
| 404 | Die Ressource konnte nicht aufgelöst werden — prüfen Sie die URL und den Parameter instance. Der Fehler-Body hat die Form {"status": "error", "message": "..."}. |
Eine händlerorientierte Übersicht der verfügbaren Methoden (TWINT, Karten, Wallets, Klarna und mehr) bietet Zahlungsmethoden. Die hier gelieferten Anbieter-IDs verwenden Sie als psp beim Erstellen von Subscriptions und in weiteren Zahlungsanfragen.