FlowAlp

Fournisseurs de paiement et identifiants de méthodes

July 30, 2026

Interrogez les fournisseurs de paiement configurés sur votre compte FlowAlp Pay et consultez les identifiants de méthodes comme TWINT.

Cet endpoint répond à deux questions récurrentes d'intégration : quels fournisseurs de paiement sont configurés sur votre compte FlowAlp Pay, et quels moyens de paiement vos clients peuvent réellement utiliser. Il vous donne aussi les ID numériques des fournisseurs que d'autres endpoints attendent dans leur paramètre psp — par exemple lors de la création d'un abonnement.

Lister les fournisseurs de paiement

GEThttps://api.pay.flowalp.com/v1.16/PaymentProvider/v1.14 · v1.15 · v1.16
ParamètreTypeDescription
instancestring (requis)Paramètre de requête : nom de votre instance (tenant).
Lister les fournisseurs de paiementbash
curl "https://api.pay.flowalp.com/v1.16/PaymentProvider/?instance=<tenant>" \
  -H "x-api-key: <api-secret>"
Lister les fournisseurs de paiement (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());
}

Réponse

ChampTypeDescription
idintegerID numérique du fournisseur. Utilisez cette valeur partout où l'API attend un paramètre psp.
namestringNom d'affichage du fournisseur tel que configuré sur votre compte.
availableBalancearray | nullPour les fournisseurs qui exposent un solde : une liste d'entrées currency/amount. Sinon null.
paymentMethodsarrayTous les codes de moyens de paiement pris en charge par le fournisseur.
activePaymentMethodsarrayLes moyens de paiement actuellement activés sur votre compte pour ce fournisseur.

Les codes de méthodes de cette réponse peuvent apparaître avec des underscores, par exemple american_express, apple_pay ou postfinance_card.

Exemple de réponseJSON
{
  "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"]
    }
  ]
}

Identifiants des moyens de paiement

Dans le reste de l'API — par exemple dans le paramètre pm d'un Gateway, qui permet de présélectionner des moyens de paiement et de sauter l'étape de sélection — les moyens de paiement sont désignés par les identifiants à tirets ci-dessous.

IdentifiantMoyen de paiement
alipayAlipay
amazon-payAmazon Pay
american-expressAmerican Express
apple-payApple Pay
bancontactBancontact
bank-transferVirement bancaire
cartes-bancairesCartes Bancaires
cryptoCryptomonnaies
diners-clubDiners Club
discoverDiscover
epsEPS
giropaygiropay
google-payGoogle Pay
idealiDEAL
invoiceAchat sur facture
jcbJCB
maestroMaestro
mastercardMastercard
pay-by-bankPay by Bank
paypalPayPal
post-finance-payPostFinance Pay
powerpayPOWERPAY
prepaymentPaiement anticipé
samsung-paySamsung Pay
sepa-direct-debitPrélèvement SEPA
klarnaKlarna
twintTWINT
unionpayUnionPay
verd-cashVerd Cash
visaVisa
v-payV PAY
wechat-payWeChat Pay
swisscom-paySwisscom Pay

Les méthodes réellement proposées à vos clients dépendent de la configuration de votre compte : une méthode n'est offerte que si un fournisseur qui la prend en charge est activé pour votre compte. Interrogez activePaymentMethods pour vérifier l'état réel plutôt que de coder des hypothèses en dur.

Erreurs

Statut HTTPSignification
404La ressource n'a pas pu être résolue — vérifiez l'URL et le paramètre instance. Le corps d'erreur a la forme {"status": "error", "message": "..."}.

Pour une vue d'ensemble côté marchand des méthodes disponibles (TWINT, cartes, wallets, Klarna et plus), lisez Moyens de paiement. Les ID de fournisseurs renvoyés ici s'utilisent comme psp lors de la création d'abonnements et dans d'autres requêtes de paiement.