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
https://api.pay.flowalp.com/v1.16/PaymentProvider/v1.14 · v1.15 · v1.16| Parameter | Type | Description |
|---|---|---|
| instance | string (required) | Query parameter: name of your 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
| Field | Type | Description |
|---|---|---|
| id | integer | Numeric ID of the provider. Use this value wherever the API expects a psp parameter. |
| name | string | Display name of the provider as configured on your account. |
| availableBalance | array | null | For providers that expose a balance: a list of currency/amount entries. null otherwise. |
| paymentMethods | array | All payment method codes the provider supports. |
| activePaymentMethods | array | The 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.
{
"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.
| Identifier | Payment method |
|---|---|
| alipay | Alipay |
| amazon-pay | Amazon Pay |
| american-express | American Express |
| apple-pay | Apple Pay |
| bancontact | Bancontact |
| bank-transfer | Bank transfer |
| cartes-bancaires | Cartes Bancaires |
| crypto | Cryptocurrencies |
| diners-club | Diners Club |
| discover | Discover |
| eps | EPS |
| giropay | giropay |
| google-pay | Google Pay |
| ideal | iDEAL |
| invoice | Purchase on invoice |
| jcb | JCB |
| maestro | Maestro |
| mastercard | Mastercard |
| pay-by-bank | Pay by Bank |
| paypal | PayPal |
| post-finance-pay | PostFinance Pay |
| powerpay | POWERPAY |
| prepayment | Prepayment |
| samsung-pay | Samsung Pay |
| sepa-direct-debit | SEPA Direct Debit |
| klarna | Klarna |
| twint | TWINT |
| unionpay | UnionPay |
| verd-cash | Verd Cash |
| visa | Visa |
| v-pay | V PAY |
| wechat-pay | WeChat Pay |
| swisscom-pay | Swisscom 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 status | Meaning |
|---|---|
| 404 | The 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.