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
https://api.pay.flowalp.com/v1.16/PaymentProvider/v1.14 · v1.15 · v1.16| Paramètre | Type | Description |
|---|---|---|
| instance | string (requis) | Paramètre de requête : nom de votre 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());
}Réponse
| Champ | Type | Description |
|---|---|---|
| id | integer | ID numérique du fournisseur. Utilisez cette valeur partout où l'API attend un paramètre psp. |
| name | string | Nom d'affichage du fournisseur tel que configuré sur votre compte. |
| availableBalance | array | null | Pour les fournisseurs qui exposent un solde : une liste d'entrées currency/amount. Sinon null. |
| paymentMethods | array | Tous les codes de moyens de paiement pris en charge par le fournisseur. |
| activePaymentMethods | array | Les 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.
{
"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.
| Identifiant | Moyen de paiement |
|---|---|
| alipay | Alipay |
| amazon-pay | Amazon Pay |
| american-express | American Express |
| apple-pay | Apple Pay |
| bancontact | Bancontact |
| bank-transfer | Virement bancaire |
| cartes-bancaires | Cartes Bancaires |
| crypto | Cryptomonnaies |
| diners-club | Diners Club |
| discover | Discover |
| eps | EPS |
| giropay | giropay |
| google-pay | Google Pay |
| ideal | iDEAL |
| invoice | Achat sur facture |
| jcb | JCB |
| maestro | Maestro |
| mastercard | Mastercard |
| pay-by-bank | Pay by Bank |
| paypal | PayPal |
| post-finance-pay | PostFinance Pay |
| powerpay | POWERPAY |
| prepayment | Paiement anticipé |
| samsung-pay | Samsung Pay |
| sepa-direct-debit | Prélèvement 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 |
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 HTTP | Signification |
|---|---|
| 404 | La 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.