FlowAlp

Payment providers and method identifiers

July 30, 2026

Query the payment providers configured for your FlowAlp Pay account and look up all payment method identifiers such as TWINT or Visa.

This endpoint answers two recurring integration questions: which payment providers are configured on your FlowAlp Pay account, and which payment methods your customers can actually use. It also gives you the numeric provider IDs that other endpoints expect in their psp parameter — for example when creating a subscription.

List payment providers

GEThttps://api.pay.flowalp.com/v1.16/PaymentProvider/v1.14 · v1.15 · v1.16
ParameterTypeDescription
instancestring (required)Query parameter: name of your instance (tenant).
List payment providersbash
curl "https://api.pay.flowalp.com/v1.16/PaymentProvider/?instance=<tenant>" \
  -H "x-api-key: <api-secret>"
List payment providers (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

FieldTypeDescription
idintegerNumeric ID of the provider. Use this value wherever the API expects a psp parameter.
namestringDisplay name of the provider as configured on your account.
availableBalancearray | nullFor providers that expose a balance: a list of currency/amount entries. null otherwise.
paymentMethodsarrayAll payment method codes the provider supports.
activePaymentMethodsarrayThe payment methods currently enabled on your account for this provider.

Method codes in this response can appear in an underscore style, for example american_express, apple_pay or postfinance_card.

Sample 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"]
    }
  ]
}

Payment method identifiers

Across the rest of the API — for example in the pm parameter of a Gateway, where you can preselect payment methods and skip the selection step — payment methods are addressed with the dash-style identifiers below.

IdentifierPayment method
alipayAlipay
amazon-payAmazon Pay
american-expressAmerican Express
apple-payApple Pay
bancontactBancontact
bank-transferBank transfer
cartes-bancairesCartes Bancaires
cryptoCryptocurrencies
diners-clubDiners Club
discoverDiscover
epsEPS
giropaygiropay
google-payGoogle Pay
idealiDEAL
invoicePurchase on invoice
jcbJCB
maestroMaestro
mastercardMastercard
pay-by-bankPay by Bank
paypalPayPal
post-finance-payPostFinance Pay
powerpayPOWERPAY
prepaymentPrepayment
samsung-paySamsung Pay
sepa-direct-debitSEPA Direct Debit
klarnaKlarna
twintTWINT
unionpayUnionPay
verd-cashVerd Cash
visaVisa
v-payV PAY
wechat-payWeChat Pay
swisscom-paySwisscom Pay

Which methods your customers actually see depends on your account configuration: a method is only offered when a provider that supports it is activated for your account. Query activePaymentMethods to check the live state instead of hard-coding assumptions.

Errors

HTTP statusMeaning
404The resource could not be resolved — check the URL and the instance parameter. The error body has the shape {"status": "error", "message": "..."}.

For a merchant-facing overview of the available methods (TWINT, cards, wallets, Klarna and more) read Payment methods. The provider IDs returned here are used as psp when creating subscriptions and in other payment requests.