Lemonway propose à ses partenaires une solution complète de traitement des paiements par carte bancaire.
👉 Comment fonctionne un paiement par carte ?
👉 Réseaux de carte acceptés & devises supportées
👉 Fonctionnalités disponibles & enregistrement de carte
👉 Statuts des transactions
👉 Pré-autorisation de carte bancaire
👉 Optimisation des paiements
👉 Cartes de test
👉 Codes d'erreur
👉 Remboursements
👉 Contestation de paiement
👉 Comment fonctionne un paiement par carte ?
Le paiement par carte fonctionne en 4 étapes clés :
- Une fois le panier confirmé, votre client clique sur le bouton de paiement de votre site web ou application.
- Une transaction par carte au statut « En attente » est créée sur votre Dashboard (Type = Entrant / Méthode = Carte / Statut = En attente).
- Ce clic génère l'ouverture de la page de paiement, où votre client renseigne les informations de sa carte bancaire (réseau, numéro, date d'expiration, code CVV) et finalise le paiement.
- La transaction est alors mise à jour avec les informations de la carte (4 premiers et 2 derniers chiffres, pays d'émission, etc.). Le statut est modifié et Lemonway prélève sa commission.
👉 Réseaux de cartes acceptés et devises supportées
| Réseau | Type de carte | Zone géographique | Devises acceptées |
|---|---|---|---|
| CB (Carte Bancaire) | Débit & crédit | 🇫🇷 France | EUR |
| Visa | Débit & crédit | International | EUR, GBP, CHF |
| Mastercard | Débit & crédit | International | EUR, GBP, CHF |
💡 L'activation de certains réseaux peut dépendre de votre contrat et de votre zone géographique. Contactez votre Account Manager pour connaître les réseaux disponibles dans votre configuration.
🚧 Les transactions Pay In et Pay Out sont toujours réalisées dans la devise de votre environnement de paiement Lemonway. Les taux de change proviennent de la banque émettrice de la carte. D'autres devises peuvent être activées sur demande selon vos volumes.
👉 Fonctionnalités disponibles & enregistrement de carte
Selon votre configuration contractuelle, les fonctionnalités suivantes sont disponibles :
| Fonctionnalité | Description | Disponibilité |
|---|---|---|
| Paiement one-shot | Transaction unique sans enregistrement de carte | ✅ Standard |
| Paiement one-click | Paiement avec carte enregistrée (tokenisée), initié par le client sans ressaisir ses coordonnées | ✅ Sur activation |
| Pré-autorisation | Gel du montant sur la carte (caution, montant final inconnu) pendant 6 jours maximum | ✅ Sur activation |
| Paiements récurrents (MIT) | Transactions initiées par le marchand : abonnements, prélèvements récurrents, facturations différées | ✅ Sur activation |
| Capture différée | Débit effectif réalisé après la phase d'autorisation | ✅ Sur activation |
| Remboursement partiel ou total | Remboursement sur la carte d'origine, depuis le Dashboard ou via l'API | ✅ Standard |
💡 La mise en place de fonctionnalités avancées (pré-autorisation, MIT, one-click) nécessite un accord contractuel spécifique. Contactez votre Account Manager pour vérifier votre éligibilité.
Les fonctionnalités one-click et MIT reposent sur la tokenisation sécurisée des cartes : Lemonway stocke les coordonnées bancaires de manière conforme aux normes PCI DSS et vous retourne un identifiant unique (card_id) lors du premier paiement avec enregistrement. Cet identifiant est ensuite utilisé pour les transactions ultérieures, sans que le client ait besoin de ressaisir ses informations.
🚧 Les paiements récurrents (MIT) sont soumis à des exigences réglementaires spécifiques (consentement initial, information du porteur de carte). Assurez-vous que votre intégration respecte ces obligations avant activation.
👉 Statuts des transactions
| Statut | Signification |
|---|---|
| ✅ Succès | La transaction a abouti et le montant est crédité sur le compte de paiement bénéficiaire. |
| 💬 En attente | La transaction n'a pas encore été créditée, mais peut évoluer vers « Succès » ou « Erreur ». |
| ⚠️ Annulé | La transaction n'a pas été créditée. Le client n'a pas finalisé le paiement (fermeture du navigateur, code 3DS non saisi, délai dépassé, etc.) |
| 🚫 Erreur | La transaction est incomplète et n'a pas pu être créditée. Elle a été annulée par Lemonway (ex. coordonnées incorrectes) ou suivant vos instructions. |
| ☑️ En attente de validation | Statut utilisé exclusivement pour les pré-autorisations. Peut évoluer vers « Succès » si la transaction est concrétisée avant expiration du délai. |
❓ Mon client affirme avoir été débité, mais la transaction n'affiche pas le statut « Succès »
Dans de très rares cas (bug lors de la transmission des informations entre votre site et notre système), une transaction peut être débitée côté client sans afficher le statut « Succès » sur le Dashboard.
Dans ce cas, voici la marche à suivre :
- Vérifiez le statut de la transaction sur votre Dashboard — elle peut être encore « En attente » si la mise à jour n'a pas encore eu lieu.
- Si le statut reste « Annulé » ou « Erreur » alors que le client a bien été débité, contactez notre équipe support en fournissant : l'identifiant de la transaction, le montant, la date et les 4 premiers / 2 derniers chiffres de la carte.
- Nos équipes effectuent une investigation. Si le débit est confirmé, la transaction est régularisée ou un remboursement est initié.
💡 Pour éviter ce type de situation, nous recommandons de ne jamais fermer la page de paiement avant la confirmation finale et de gérer les timeouts via les webhooks Lemonway.
👉 Pré-autorisation de carte bancaire
La pré-autorisation est utile lorsque le montant final de la transaction est inconnu au moment de la réservation (ex. société de location nécessitant une caution, prestation facturée à la consommation).
Elle permet de :
- Vérifier la validité de la carte du client
- ❄️ Geler le montant sur la carte pendant une période maximum de 6 jours (144 heures)
Fonctionnement selon le type de carte :
- Carte de crédit : le montant est bloqué sur le plafond de la carte pendant la période de pré-réservation
- Carte de débit : le montant est déduit du compte bancaire rattaché à la carte
La pré-autorisation apparaît comme une transaction Pay In « En attente » sur votre Dashboard.
Vous avez ensuite deux options :
- Débiter la carte (total ou partiel) avant expiration du délai → le statut passe de « En attente » à « Succès ». Si le montant débité est inférieur au montant pré-autorisé, le solde bloqué est libéré automatiquement.
- Ne rien faire → le blocage est annulé à la fin de la période de pré-réservation (carte de crédit) ou le débit est annulé (carte de débit).
⚠️ L'activation de la pré-autorisation s'applique à l'ensemble de la plateforme : toutes vos transactions seront pré-autorisées par défaut. Vous pouvez valider chaque transaction via l'API sans impact pour votre client.
👉 Optimisation des paiements
Lemonway a renforcé son infrastructure de traitement des paiements par carte afin d'améliorer les performances pour tous ses partenaires. Ces évolutions apportent les bénéfices suivants :
| Amélioration | Bénéfice pour votre plateforme |
|---|---|
| Routing intelligent (Smart Routing) | Les transactions sont automatiquement orientées vers le canal de traitement le plus performant selon le profil de la transaction (devise, pays d'émission, montant, historique), maximisant ainsi le taux d'acceptation. |
| Architecture multi-acquéreur | Lemonway s'appuie sur plusieurs acquéreurs bancaires. En cas d'indisponibilité ou de refus sur un canal, un mécanisme de fallback automatique redirige la transaction vers un autre acquéreur pour limiter les pertes de paiement. |
| Meilleur taux d'acceptation | La combinaison du routing intelligent et de la gestion des exemptions 3DS permet de réduire les frictions inutiles et d'augmenter le taux de conversion sur vos flux de paiement. |
| Monitoring en temps réel | Une supervision continue des flux permet une détection rapide des anomalies et une intervention proactive de nos équipes en cas d'incident. |
💡 Ces optimisations sont actives par défaut pour tous les partenaires utilisant le module de paiement par carte Lemonway. Aucune action de votre part n'est requise pour en bénéficier.
👉 Cartes de test (environnement sandbox)
En environnement sandbox, utilisez les numéros de carte ci-dessous pour simuler différents comportements de paiement. Pour toutes les cartes de test, utilisez :
- Date d'expiration : toute date future (ex. 12/26)
- CVC : n'importe quel code à 3 chiffres (ex. 123)
⚠️ Les cartes de test sont uniquement valables en environnement sandbox. Toute utilisation d'une carte de test en environnement de production entraîne un refus automatique (card.test).
Paiements réussis
| Numéro de carte | Réseau | Comportement |
|---|---|---|
| 4242 4242 4242 4242 | Visa | Paiement réussi |
| 5555 5555 5555 4444 | Mastercard | Paiement réussi |
Paiements réussis selon le pays d'émission
| Numéro de carte | Pays | Réseau |
|---|---|---|
| 4977 8300 0000 0001 | 🇫🇷 France | Visa |
| 4360 0000 0100 0005 | 🇫🇷 France | Visa / Carte Bancaire (CB) |
| 5130 2900 0000 0009 | 🇫🇷 France | Mastercard / Carte Bancaire (CB) |
| 4658 5800 0000 0008 | 🇬🇧 Royaume-Uni | Visa |
| 4023 6000 0000 0002 | 🇮🇹 Italie | Visa |
| 4571 7300 0000 0003 | 🇩🇰 Danemark | Visa |
Comportements 3D Secure spécifiques
| Numéro de carte | Comportement 3DS |
|---|---|
| 4000 0000 0000 0101 | 3DS requis et supporté (challenge) |
| 4000 0000 0000 0119 | 3DS non supporté sur la carte |
| 4000 0000 0000 3055 | 3DS v2 — flux frictionless (sans fingerprint) |
| 4000 0000 0000 3063 | 3DS v2 — flux frictionless (avec fingerprint) |
| 4000 0000 0000 3253 | 3DS v2 requis pour SCA, pas d'authentification pour les MIT |
Comportements d'autorisation spéciaux
| Numéro de carte | Comportement simulé |
|---|---|
| 4000 0000 0000 0002 | Carte refusée |
| 4000 0000 0000 2180 | Refus — card.do-not-honor
|
| 4000 0000 0000 2198 | Refus — card.possible-fraud
|
| 4000 0000 0000 2206 | Refus — card.no-money (fonds insuffisants) |
| 4000 0000 0000 2214 | Refus — card.expired
|
| 4000 0000 0000 2222 | Refus — card.stolen (carte déclarée volée) |
| 4000 0000 0000 2230 | Refus — card.failed-cvc (CVC invalide) |
| 4000 0000 0000 2255 | Refus — card.not-authorized
|
| 4000 0000 0000 0069 | Paiement réussi, mais un chargeback est initié immédiatement |
| 4000 0000 0000 0077 | Paiement réussi, mais tout remboursement sera refusé |
| 4000 0000 0000 0028 | La vérification du CVC échoue |
👉 Codes d'erreur
Lorsqu'une transaction par carte est refusée, un code d'erreur est retourné dans la réponse API et visible dans le Dashboard Lemonway. Ce tableau vous aide à identifier la cause du refus et l'action corrective à mener.
🛡️ Fraude & Sécurité
| Code d'erreur | Description | Action recommandée |
|---|---|---|
gateway.possible-fraud |
Transaction signalée comme fraude potentielle | Contacter l'équipe Fraude Lemonway |
card.possible-fraud |
Paiement bloqué pour fraude potentielle par l'émetteur | Contacter l'équipe Fraude Lemonway |
card.blacklisted |
Carte sur liste noire — ne pas relancer | Ne pas relancer |
card.stolen |
Carte déclarée volée — ne pas relancer | Ne pas relancer |
card.lost |
Carte déclarée perdue — ne pas relancer | Ne pas relancer |
card.security-violation |
Menace de sécurité détectée — ne pas relancer | Ne pas relancer |
card.high-risk |
Transaction signalée à haut risque | Analyser avant toute relance |
routing-rules.transaction-blocked |
Transaction bloquée par les règles Lemonway | Contacter l'équipe Fraude & Litiges Lemonway |
💳 Erreurs de validation de carte
| Code d'erreur | Description |
|---|---|
card.invalid |
Carte invalide (numéro, date d'expiration ou CVC) |
card.invalid-number |
Numéro de carte invalide |
card.invalid-expiry-date |
Date d'expiration invalide |
card.missing-cvc |
CVC manquant mais obligatoire |
card.invalid-brand |
Réseau de carte invalide ou non supporté |
card.invalid-merchant |
Marchand invalide — contacter le support Lemonway |
card.not-found |
Informations de carte introuvables |
🏦 Erreurs Émetteur / Acquéreur
| Code d'erreur | Description | Action recommandée |
|---|---|---|
card.issuer-failed |
La banque émettrice a rencontré une erreur | Relancer ultérieurement |
card.acquirer-failed |
Échec de traitement côté acquéreur | Contacter le support Lemonway |
card.issuer-down |
La banque émettrice est indisponible | Relancer ultérieurement |
card.network-failed |
Impossible de contacter le réseau carte | Contacter le support Lemonway |
card.issuer-maintenance |
La banque émettrice est en maintenance | Relancer ultérieurement |
🔄 Refus génériques
| Code d'erreur | Description | Action recommandée |
|---|---|---|
card.declined |
Paiement refusé, aucune information complémentaire disponible | Demander au client de contacter sa banque |
card.do-not-honor |
Refus générique de la banque émettrice (code par défaut) | Demander au client de contacter sa banque |
card.please-retry |
Paiement refusé — une relance est possible | Relancer la transaction |
card.dont-retry |
Paiement refusé — ne pas relancer | Ne pas relancer |
payment.declined |
Paiement refusé, aucune information complémentaire | Demander au client de contacter sa banque |
🔒 Conformité & Situations spéciales
| Code d'erreur | Description | Action recommandée |
|---|---|---|
request.transaction-blocked |
Bloqué pour raisons de conformité — ne pas relancer | Ne pas relancer |
card.keep-card |
La carte doit être retenue — ne pas relancer | Ne pas relancer |
card.not-authorized |
Carte non autorisée pour ce paiement | Demander au client un autre moyen de paiement |
card.region-not-authorized |
Non autorisé dans cette région géographique | Vérifier la configuration géographique |
card.currency-unsupported |
Devise non supportée par cette carte | Vérifier la devise de la transaction |
card.type-not-supported |
Type de carte non supporté | Vérifier les réseaux activés sur votre compte |
card.test |
Carte de test utilisée en environnement de production | Utiliser une carte réelle en production |
💡 Pour tout code d'erreur non listé ici ou nécessitant une analyse approfondie, contactez notre équipe support en précisant l'identifiant de transaction et le code d'erreur retourné.
👉 Remboursements
Comment rembourser une transaction par carte ?
Lemonway vous permet de rembourser à tout moment les transactions par carte effectuées par vos clients, en totalité ou en partie, depuis votre Dashboard.
- Dans le Dashboard, cliquez sur Transactions puis Toutes les opérations.
- Recherchez l'ID de la transaction.
- Cliquez sur l'ID dans la liste de résultats.
- Sur la page Détails de l'opération, cliquez sur Remboursement.
- Indiquez le montant total ou partiel à rembourser, saisissez votre mot de passe et cliquez sur Envoyer.
Une fois confirmée, la demande est soumise. La transaction apparaît 💬 En attente sur votre Dashboard, puis passe à ✅ Succès une fois traitée. Elle peut passer à 🚫 Erreur PSP si le remboursement ne peut pas être exécuté (carte expirée, signalée volée, etc.).
| Paramètre | Détail |
|---|---|
| Délai de crédit | 2 à 5 jours ouvrés (selon la banque émettrice) |
| Limite temporelle | Impossible au-delà de 12 mois après la transaction initiale |
| Commission Lemonway | Non restituée en cas de remboursement |
| Carte expirée ou bloquée | Le remboursement peut échouer — statut Erreur PSP |
⚠️ Le remboursement est toujours effectué sur la carte d'origine utilisée lors du paiement. Il n'est pas possible de rembourser sur un autre moyen de paiement via ce mécanisme.
Comment identifier un remboursement dans mon Dashboard ?
Une transaction par carte Pay Out correspond à un remboursement effectué.
- Dans le Dashboard, cliquez sur Transactions puis Toutes les opérations.
- Cliquez sur l'icône de filtre dans la colonne Catégorie.
- Sélectionnez Remboursement et cliquez sur OK.
👉 Contestation de paiement
Un chargeback survient lorsqu'un porteur de carte conteste une transaction directement auprès de sa banque émettrice. Contrairement à un remboursement initié par votre plateforme, il est déclenché par le client et peut entraîner une révision de la transaction par Lemonway.
👉 Consultez notre article dédié : Chargebacks et disputes