FlowAlp

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

GEThttps://api.pay.flowalp.com/v1.16/PaymentProvider/v1.14 · v1.15 · v1.16
ParametroTipoDescrizione
instancestring (obbligatorio)Query parameter: nome della tua instance (tenant).
Elencare i payment providerbash
curl "https://api.pay.flowalp.com/v1.16/PaymentProvider/?instance=<tenant>" \
  -H "x-api-key: <api-secret>"
Elencare i payment provider (SDK PHP)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

CampoTipoDescrizione
idintegerID numerico del provider. Usa questo valore ovunque l'API richieda un parametro psp.
namestringNome visualizzato del provider come configurato sul tuo account.
availableBalancearray | nullPer i provider che espongono un saldo: un elenco di voci currency/amount. Altrimenti null.
paymentMethodsarrayTutti i codici dei metodi di pagamento supportati dal provider.
activePaymentMethodsarrayI 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.

Esempio di 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"]
    }
  ]
}

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.

IdentificatoreMetodo di pagamento
alipayAlipay
amazon-payAmazon Pay
american-expressAmerican Express
apple-payApple Pay
bancontactBancontact
bank-transferBonifico bancario
cartes-bancairesCartes Bancaires
cryptoCriptovalute
diners-clubDiners Club
discoverDiscover
epsEPS
giropaygiropay
google-payGoogle Pay
idealiDEAL
invoiceAcquisto su fattura
jcbJCB
maestroMaestro
mastercardMastercard
pay-by-bankPay by Bank
paypalPayPal
post-finance-payPostFinance Pay
powerpayPOWERPAY
prepaymentPagamento anticipato
samsung-paySamsung Pay
sepa-direct-debitAddebito diretto SEPA
klarnaKlarna
twintTWINT
unionpayUnionPay
verd-cashVerd Cash
visaVisa
v-payV PAY
wechat-payWeChat Pay
swisscom-paySwisscom 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 HTTPSignificato
404La 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.