FlowAlp

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

GEThttps://api.pay.flowalp.com/v1.16/PaymentProvider/v1.14 · v1.15 · v1.16
ParameterTypBeschreibung
instancestring (erforderlich)Query-Parameter: Name Ihrer Instance (Tenant).
Zahlungsanbieter auflistenbash
curl "https://api.pay.flowalp.com/v1.16/PaymentProvider/?instance=<tenant>" \
  -H "x-api-key: <api-secret>"
Zahlungsanbieter auflisten (PHP SDK)PHP
<?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

FeldTypBeschreibung
idintegerNumerische ID des Anbieters. Verwenden Sie diesen Wert überall dort, wo die API einen psp-Parameter erwartet.
namestringAnzeigename des Anbieters, wie auf Ihrem Konto konfiguriert.
availableBalancearray | nullBei Anbietern mit einsehbarem Guthaben: eine Liste von currency/amount-Einträgen. Andernfalls null.
paymentMethodsarrayAlle Zahlungsmethoden-Codes, die der Anbieter unterstützt.
activePaymentMethodsarrayDie 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.

Beispiel-ResponseJSON
{
  "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.

IdentifierZahlungsmethode
alipayAlipay
amazon-payAmazon Pay
american-expressAmerican Express
apple-payApple Pay
bancontactBancontact
bank-transferBanküberweisung
cartes-bancairesCartes Bancaires
cryptoKryptowährungen
diners-clubDiners Club
discoverDiscover
epsEPS
giropaygiropay
google-payGoogle Pay
idealiDEAL
invoiceKauf auf Rechnung
jcbJCB
maestroMaestro
mastercardMastercard
pay-by-bankPay by Bank
paypalPayPal
post-finance-payPostFinance Pay
powerpayPOWERPAY
prepaymentVorauskasse
samsung-paySamsung Pay
sepa-direct-debitSEPA-Lastschrift
klarnaKlarna
twintTWINT
unionpayUnionPay
verd-cashVerd Cash
visaVisa
v-payV PAY
wechat-payWeChat Pay
swisscom-paySwisscom 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-StatusBedeutung
404Die 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.