Tests pour développeurs
July 30, 2026
Fonctionnement du mode test FlowAlp Pay : simulez des paiements sans argent réel, sachez quoi tester avant la production et isolez les données.
FlowAlp Pay vous permet de répéter le flux de paiement complet — checkout, redirects, webhooks, remboursements — sans déplacer d'argent réel. Le mode test est un réglage des moyens de paiement de votre compte, pas un système séparé : vous gardez la même instance, les mêmes identifiants API et les mêmes endpoints.
Fonctionnement du mode test
- Dans le dashboard, vous basculez un moyen de paiement (ou la configuration de son provider) de Live à Test.
- Tant que le mode test est actif, le checkout étiquette les moyens concernés comme TEST et affiche les cartes de test utilisables directement sur la page de paiement.
- Les transactions ainsi créées sont enregistrées comme transactions de test : aucun argent ne circule et rien n'est versé sur votre compte bancaire.
- Les paiements de test peuvent être remboursés, ce qui permet de répéter aussi vos processus de remboursement.
La disponibilité du mode test pour chaque moyen de paiement dépend de la configuration de votre compte. Certains moyens, comme TWINT et PostFinance, se terminent toujours avec un statut confirmé en mode test — simulez les refus avec les cartes de test.
Quoi tester avant la mise en production
- Identifiants : SignatureCheck réussit avec les identifiants que votre système de production utilisera.
- Création de Gateway avec des montants réalistes en unités mineures et un referenceId unique par commande (Première requête API).
- Un paiement par résultat : confirmé, refusé et annulé — y compris les URL de redirect success, failed et cancel correspondantes (Cartes de test et scénarios).
- Réception des webhooks, vérification de signature et traitement idempotent des livraisons répétées (Configurer les webhooks).
- Un remboursement d'un paiement de test, de bout en bout.
- Réconciliation : la récupération de la transaction via l'API renvoie le statut enregistré par votre système (Lister et récupérer les Transactions).
Simuler les résultats
Les numéros de cartes de test permettent de déclencher de manière déterministe des paiements confirmés et refusés. Les numéros, ainsi que les scénarios pour TWINT, wallets et remboursements, sont réunis dans Cartes de test et scénarios.
Séparer test et production
- Pendant les tests, faites pointer les URL de redirect vers votre environnement de staging.
- N'utilisez jamais d'API Secret de production dans des configurations de test publiques ou automatisées — voir Identifiants API.
- Dans le dashboard, chaque transaction porte son mode : vous pouvez filtrer la liste pour n'afficher que les paiements réels.
- Les transactions de test ne peuvent pas être supprimées — le filtrage est le moyen prévu pour les masquer.
Plan de test complet ? Poursuivez avec Cartes de test et scénarios pour les numéros de carte concrets, puis déroulez la checklist de mise en production.