Intégrations
Stripe (Paiements en ligne)
Stripe gère les paiements de votre boutique en ligne.
Configurer Stripe
- Créez un compte sur stripe.com
- Dans Epsylon : Paramètres → Intégrations → Stripe
- Renseignez vos clés API (disponibles dans le tableau de bord Stripe) :
- Clé publique (
pk_live_...) - Clé secrète (
sk_live_...) - Configurez le webhook Stripe vers l'URL fournie par Epsylon
- Cliquez sur Tester la connexion
Utilisez les clés de test (
pk_test_...) pendant la phase de configuration pour ne pas traiter de vrais paiements.
Alma (Paiement en plusieurs fois)
Alma permet à vos clients de payer en 2x, 3x ou 4x sans frais sur votre boutique.
Configurer Alma
- Créez un compte sur getalma.eu
- Dans Epsylon : Paramètres → Intégrations → Alma
- Renseignez votre clé API Alma
- Choisissez les échéances proposées (2x, 3x, 4x)
Alma apparaît automatiquement comme mode de paiement sur votre boutique une fois configuré.
API publique Epsylon (Boutique headless)
Epsylon expose une API REST permettant à des applications tierces (vitrine e-commerce sur mesure, WooCommerce, outils internes...) de piloter votre catalogue, votre stock et vos commandes.
- Base URL :
https://app-epsylon.fr/api/public/v1/shop - Format : JSON, réponses de la forme
{ "success": true, "data": ... }.
Obtenir une clé API
- Paramètres → Intégrations
- Créez une clé API. Une clé est rattachée à un magasin et ne voit que son catalogue.
- La clé peut être restreinte à une liste d'IP et porte des permissions (scopes).
Le secret n'est affiché qu'une seule fois à la création. Copiez-le immédiatement.
Authentification
Chaque requête envoie deux en-têtes :
X-API-Key: epsylon_xxxxxxxx
X-API-Secret: xxxxxxxxxxxxxxxx
Permissions (scopes)
| Scope | Donne accès à |
|---|---|
read |
Lecture : catalogue, stock, magasins, suivi de commande |
write:orders |
Créer / annuler des commandes |
write:products |
Écriture produit (caractéristiques, documents) |
admin |
Tout (inclut les scopes ci-dessus) |
Principaux endpoints
| Méthode | Endpoint | Description |
|---|---|---|
GET |
/products?store_id=… |
Lister le catalogue |
GET |
/products/:id |
Détail d'un produit |
GET |
/products/:id/availability |
Disponibilité / stock |
GET |
/stores |
Lister les magasins |
POST |
/orders |
Créer une commande |
GET |
/orders/:id |
Suivi d'une commande |
Une clé absente ou invalide renvoie 401, un scope insuffisant renvoie 403.
Exports comptables
Voir la section Exports comptables pour les exports FEC et journaux compatibles avec Sage, EBP, Cegid, QuickBooks, etc.