Démarrer avec LodinPay

Bienvenue. Ce guide vous fait passer de zéro à un premier paiement instantané — sans carte, sans frais de réseau, sans attente. Que vous intégriez via un plugin CMS, l'API, un ERP ou une application mobile, vous repartez d'ici avec un plan clair.

Qu'est-ce que LodinPay ?

LodinPay permet aux commerçants d'accepter des paiements par virement instantané SEPA (SCT Inst) via le protocole Request-to-Pay (RTP). Le client autorise le paiement depuis sa propre application bancaire avec authentification forte (SCA) : pas de saisie de carte, pas de réseau carte, pas de rétrofacturation, règlement sur votre IBAN en moins de dix secondes, 24 h/24, 7 j/7.

LodinPay est exploité par Effyis Europe, établissement de paiement agréé en France (PSDFR-ACPR-17758).

L'écosystème se compose de trois produits, qui se complètent :

• Passerelle RTP — l'API et les plugins qui génèrent un lien ou un QR de paiement.
• Plateforme Lodin Merchant — la console marchand : agrégation bancaire, virements sortants, pilotage de trésorerie.
• Lodin SmartPOS — l'application mobile qui transforme un smartphone en terminal de paiement.

Pourquoi LodinPay ?

• Encaissement instantané — fonds reçus sur votre IBAN en quelques secondes, 24 h/24, 7 j/7.
• Aucun frais carte — paiement sur les rails SEPA, sans interchange.
• Pas de rétrofacturation — la transaction est définitive dès la validation SCA.
• Aucune installation côté client — votre client paie depuis son application bancaire habituelle.
• Conformité native — agrément ACPR, chiffrement de bout en bout, lettrage automatique.

Choisir votre point d'entrée

Vous êtes…	Utilisez	Effort
Marchand sur PrestaShop, Shopify, Shopware	Plugin CMS	~15 minutes
Développeur intégrant un site sur mesure ou un SaaS	API RTP Gateway	1 à 3 jours
Facturation B2B sur Odoo ou Dolibarr	Plugin ERP	~30 minutes
Commerce physique (Boutique / Magasin)	Lodin SmartPOS	Téléchargement sur store
Besoin d'une console tout-en-un	Plateforme Lodin Merchant	Création de compte

Pas sûr ? Si vous vendez en ligne sur un CMS standard, le plugin fait l'intégration pour vous. L'API est faite pour ce qui ne rentre dans aucun moule. SmartPOS suffit si vous encaissez uniquement en face-à-face.

Prérequis

• Un IBAN d'entreprise en zone SEPA pour recevoir les fonds.
• Vos identifiants (Client ID et Client Secret) — créés depuis la Console Lodin.
• Pour l'API : un environnement HTTPS sortant et un endpoint webhook public accessible en HTTPS.

Démarrage rapide — Plugin CMS

1. Installez le plugin sur votre plateforme : PrestaShop, Shopify ou Shopware.
2. Saisissez votre Client ID et Client Secret (Console Lodin → Settings → API keys).
3. Validez de bout en bout dans le sandbox.
4. Basculez sur les identifiants de production et activez le moyen de paiement en back-office.

Le plugin se charge des appels API, de la signature HMAC et de la réception du webhook. Vous n'écrivez aucun code.

Démarrage rapide — Intégration API

Pour une intégration sur mesure, le flux tient en quatre étapes :

1. Récupérez vos identifiants sandbox depuis la Console Lodin (Settings → API keys → Sandbox).
2. Appelez l'API pour générer un lien de paiement, signé en HMAC-SHA256.
3. Redirigez le client vers l'url retournée — ou affichez-la en QR code.
4. Recevez le webhook signé pour confirmer le statut final côté serveur.

Le détail technique vit dans la référence API, pas ici :

• Aperçu de l'API — endpoint, en-têtes, exemple curl exécutable.
• Authentification & signature — calcul du X-Signature en PHP, Node.js, Python.
• Spécification webhook — vérification, retries, idempotence.

Cycle de vie d'une commande

Chaque état terminal est un puits : aucun webhook ultérieur ne doit faire muter une commande déjà PAID, PAYMENT_ERROR ou CANCELED. L'idempotence est le contrat. Voir la machine à états complète.

Environnements

Environnement	URL de base	Identifiants
Sandbox	https://api-preprod.lodinpay.com/merchant-service/extensions/pay/rtp	Console → Settings → API keys
Production	Communiquée lors du go-live	Délivrés après revue de conformité

Validez systématiquement votre intégration en sandbox avant de basculer en production. Les identifiants ne sont pas interchangeables entre les deux environnements.

Et après ?

• Comment fonctionne le paiement par virement — le parcours d'un paiement, de la demande à la réception des fonds.
• Qu'est-ce que l'Open Banking ? — le cadre dans lequel LodinPay opère, ses acteurs et sa régulation.
• AISP — Service d'information sur les comptes — agrégation bancaire et accès aux données de compte.
• PISP — Service d'initiation de paiement — le rôle d'initiateur de paiement assuré par LodinPay.
• Glossaire — vocabulaire métier, réglementaire et technique.
• Support — comment nous contacter, problèmes fréquents.

Une question ? Écrivez à [email protected] — un humain répond en moins d'un jour ouvré. Statut en temps réel : status.lodinpay.com.