Payment provider e identificatori dei metodi
July 30, 2026
Interroga i payment provider configurati sul tuo account FlowAlp Pay e consulta gli identificatori dei metodi di pagamento come TWINT o Visa.
Questo endpoint risponde a due domande ricorrenti nelle integrazioni: quali payment provider sono configurati sul tuo account FlowAlp Pay e quali metodi di pagamento possono usare davvero i tuoi clienti. Ti fornisce inoltre gli ID numerici dei provider che altri endpoint richiedono nel parametro psp — ad esempio quando crei una subscription.
Elencare i payment provider
https://api.pay.flowalp.com/v1.16/PaymentProvider/v1.14 · v1.15 · v1.16| Parametro | Tipo | Descrizione |
|---|---|---|
| instance | string (obbligatorio) | Query parameter: nome della tua 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
| Campo | Tipo | Descrizione |
|---|---|---|
| id | integer | ID numerico del provider. Usa questo valore ovunque l'API richieda un parametro psp. |
| name | string | Nome visualizzato del provider come configurato sul tuo account. |
| availableBalance | array | null | Per i provider che espongono un saldo: un elenco di voci currency/amount. Altrimenti null. |
| paymentMethods | array | Tutti i codici dei metodi di pagamento supportati dal provider. |
| activePaymentMethods | array | I metodi di pagamento attualmente attivi sul tuo account per questo provider. |
I codici dei metodi in questa response possono comparire nella variante con underscore, ad esempio american_express, apple_pay o 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"]
}
]
}Identificatori dei metodi di pagamento
Nel resto dell'API — ad esempio nel parametro pm di un Gateway, con cui puoi preselezionare i metodi di pagamento e saltare il passaggio di selezione — i metodi si indicano con gli identificatori con trattino elencati qui sotto.
| Identificatore | Metodo di pagamento |
|---|---|
| alipay | Alipay |
| amazon-pay | Amazon Pay |
| american-express | American Express |
| apple-pay | Apple Pay |
| bancontact | Bancontact |
| bank-transfer | Bonifico bancario |
| cartes-bancaires | Cartes Bancaires |
| crypto | Criptovalute |
| diners-club | Diners Club |
| discover | Discover |
| eps | EPS |
| giropay | giropay |
| google-pay | Google Pay |
| ideal | iDEAL |
| invoice | Acquisto su fattura |
| jcb | JCB |
| maestro | Maestro |
| mastercard | Mastercard |
| pay-by-bank | Pay by Bank |
| paypal | PayPal |
| post-finance-pay | PostFinance Pay |
| powerpay | POWERPAY |
| prepayment | Pagamento anticipato |
| samsung-pay | Samsung Pay |
| sepa-direct-debit | Addebito diretto SEPA |
| klarna | Klarna |
| twint | TWINT |
| unionpay | UnionPay |
| verd-cash | Verd Cash |
| visa | Visa |
| v-pay | V PAY |
| wechat-pay | WeChat Pay |
| swisscom-pay | Swisscom Pay |
I metodi che i tuoi clienti vedono davvero dipendono dalla configurazione del tuo account: un metodo viene proposto solo se sul tuo account è attivo un provider che lo supporta. Interroga activePaymentMethods per verificare lo stato reale invece di dare per scontate le disponibilità.
Errori
| Stato HTTP | Significato |
|---|---|
| 404 | La risorsa non è stata trovata — controlla l'URL e il parametro instance. Il body di errore ha la forma {"status": "error", "message": "..."}. |
Per una panoramica lato merchant dei metodi disponibili (TWINT, carte, wallet, Klarna e altri) leggi Metodi di pagamento. Gli ID dei provider restituiti qui si usano come psp nella creazione delle subscription e nelle altre richieste di pagamento.