Aperçu FlowAlp Pay pour développeurs

FlowAlp Pay est la solution de paiement white-label de FlowAlp. Elle expose une Merchant API et des outils de checkout que vous pouvez intégrer à des sites web, plateformes e-commerce, applications et logiciels métier.

Cette documentation s'adresse aux développeurs, intégrateurs et marchands disposant de compétences techniques. Elle ne suppose pas de connaissance de la technologie sous-jacente.

Concepts essentiels

Concept | Rôle
Instance | Identifiant technique du marchand. Apparaît dans le domaine de la page de paiement et comme paramètre de requête `instance` dans les appels API.
Merchant API | API REST sur `https://api.pay.flowalp.com` pour créer des Gateways, gérer les transactions, subscriptions et autres ressources.
Gateway | Checkout personnalisable créé via l'API pour des flux de paiement sur mesure.
Merchant tools | Outils prêts à l'emploi configurés dans le back-office (peu ou pas de code).
Plugin | Intégrations préconstruites pour e-commerce, CMS et logiciels métier.

Options d'intégration

Gateway personnalisé

Utilisez un Gateway lorsque le paiement doit s'intégrer à votre propre checkout :

• créez un Gateway via la Merchant API ;
• redirigez (ou intégrez) le client vers la page de paiement ;
• recevez les mises à jour via webhook et vérification côté serveur.

Voir Accepter un paiement et Créer un Gateway.

TODO FlowAlp: creare e collegare la pagina interna payments/one

Plugins et intégrations existantes

Des intégrations prêtes à l'emploi sont disponibles pour de nombreuses plateformes e-commerce, CMS et métier. Voir :

• Vue d'ensemble e-commerce
• Vue d'ensemble CMS
• Vue d'ensemble logiciels métier

TODO FlowAlp: creare e collegare le pagine overview integrazioni

Embedding

Le Gateway (ou les merchant tools) peuvent être présentés sous forme de :

• redirect vers la page de paiement ;
• iFrame ;
• fenêtre modale ;
• intégration dans une application mobile.

Voir Vue d'ensemble Embedding.

TODO FlowAlp: creare e collegare checkout/overview

Merchant tools

Si vous n'avez pas besoin d'un checkout personnalisé, vous pouvez utiliser des outils configurés dans le compte marchand sans appeler l'API. L'embedding de ces outils utilise les mêmes modes que le Gateway.

Parcours recommandé

• Choisir une intégration
• Nom de l'instance
• Identifiants API
• Authentification
• Première requête API
• Webhooks et vérification du paiement (ne pas se fier au seul redirect)

Domaines FlowAlp Pay

Usage | URL
Merchant API | `https://api.pay.flowalp.com`
Connexion marchand | `https://login.pay.flowalp.com`
Inscription | `https://signup.pay.flowalp.com`
Back-office plateforme | `https://backoffice.pay.flowalp.com`
Page de paiement | `https://<instance>.pay.flowalp.com`

TODO FlowAlp: verify operational status of https://pay.flowalp.com (root host) before publication.

Étapes suivantes

• Choisir une intégration
• Vue d'ensemble Merchant API