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 et devises supportées
👉 Fonctionnalités disponibles et 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 et 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)
⚠️ Ces cartes de test sont uniquement valables en environnement sandbox et si vous êtes sur la nouvelle structure carte de Lemonway.
Toute utilisation d'une carte de test en environnement de production entraîne un refus automatique (card.test).
Pour plus d'informations, contactez votre Account Manager ou le support Lemonway.
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 |
| 4338 3000 0000 0009 | 🇦🇷 Argentine | Visa |
| 4835 9100 0000 0003 | 🇨🇳 Chine | 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 |
| 4000 0000 0000 0259 | 3DS v2 supporté, v1 non supporté |
| 4000 0000 0000 3238 | 3DS v2 non supporté, v1 supporté |
| 4000 0000 0000 3220 | 3DS v2 — fingerprint échoue |
| 4000 0000 0000 3246 | 3DS v1 requis mais v2 non supporté |
Comportements d'autorisation spéciaux
| Numéro de carte | Comportement simulé |
|---|---|
| 4000 0000 0000 0002 | Carte refusée |
| 4000 0000 0000 0010 | Autorisation réussie, mais toute capture échouera |
| 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 2248 | Refus — card.failed-avs
|
| 4000 0000 0000 2255 | Refus — card.not-authorized
|
| 4000 0000 0000 2263 | Refus — card.inactive
|
| 4000 0000 0000 2271 | Refus — card.lost
|
| 4000 0000 0000 2289 | Refus — card.region-not-authorized
|
| 4127 9694 2058 7632 | Refus — card.blacklisted
|
Comportements spéciaux
| Numéro de carte | Comportement simulé |
|---|---|
| 4000 0000 0000 0028 | La vérification du CVC échoue |
| 4000 0000 0000 1216 | Vérification réussie, mais toute transaction échouera |
| 4000 0000 0000 0069 | Paiement réussi, mais un chargeback est initié immédiatement |
| 4000 0000 0000 0200 | Paiement réussi, mais un chargeback échoué est initié immédiatement |
| 4000 0000 0000 0309 | Paiement réussi, mais une demande de récupération est initiée immédiatement |
| 4000 0000 0000 0077 | Paiement réussi, mais tout remboursement sera refusé |
| 4000 0000 0000 4004 | Paiement réussi, mais une notification de fraude sera envoyée |
| 4000 0000 0000 6223 | Paiement réussi, mais toute capture incrémentale échouera |
| 4000 0000 0000 0531 | Autorisation réussie, mais toute autorisation incrémentale échouera |
| 4000 0000 0000 3303 | Autorisation réussie, mais toute autorisation incrémentale échouera avec card.no-money
|
| 4000 0000 0000 6009 | Vérification réussie, mais les nouvelles autorisations échoueront avec card.no-money
|
| 4000 0000 0000 4301 | Vérification réussie, mais les nouvelles autorisations échoueront avec card.expired
|
| 5337 4800 0000 7168 | La transaction échouera avec le code de recommandation do-not-retry
|
👉 Codes d'erreur
Lorsqu'une transaction par carte est refusée, un code d'erreur est visible dans le Dashboard Lemonway. Ce tableau vous aide à identifier la cause du refus et l'action corrective à mener.
⚠️ Ces codes ne sont pas retournés dans la réponse API et ne sont visibles uniquement si vous êtes sur la nouvelle structure carte de Lemonway. Pour plus d'informations, contactez votre Account Manager ou le support Lemonway
🛡️ Fraude & Sécurité
| Code d'erreur | Description | Action recommandée |
|---|---|---|
gateway.possible-fraud |
Transaction signalée comme fraude potentielle | Contacter le support Lemonway |
card.possible-fraud |
Paiement bloqué pour fraude potentielle par l'émetteur | Contacter l'émetteur |
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 |
card.possible-counterfeit |
Carte potentiellement contrefaite | Analyser la transaction avant toute relance |
routing-rules.transaction-blocked |
Transaction bloquée par les règles Lemonway | Contacter le support 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.invalid-name |
Nom du porteur invalide |
card.invalid-expiry-month |
Mois d'expiration invalide |
card.invalid-expiry-year |
Année d'expiration invalide |
card.missing-expiry |
Date d'expiration manquante |
card.missing-number |
Numéro de carte manquant |
card.missing-name |
Nom du porteur manquant |
card.missing-pin |
Code PIN manquant |
card.bad-track-data |
Données de piste invalides (date d'expiration ou CVC) |
card.invalid-account |
Compte bancaire invalide |
card.invalid-amount |
Montant de transaction invalide |
card.invalid-scheme |
Schéma de carte invalide ou non supporté |
card.invalid-transaction |
Transaction invalide |
card.formatting-error |
Erreur de formatage |
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 |
card.processing-error |
Échec du traitement côté Acquéreur/Émetteur | Contacter le support Lemonway |
card.issuer-not-found |
Banque émettrice introuvable | Contacter le support Lemonway |
card.acquirer-not-found |
Acquéreur introuvable | Contacter le support Lemonway |
card.issuer-malfunction |
Dysfonctionnement de la banque émettrice | 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 |
card.no-action-taken |
Aucune action effectuée — relancer la transaction | Relancer la transaction |
gateway.declined |
Transaction signalée comme fraude potentielle | Contacter le support Lemonway |
⚙️ Erreurs Gateway
| Code d'erreur | Description | Action recommandée |
|---|---|---|
gateway.blocked |
Problème technique | Contacter le support Lemonway |
gateway.configuration-error |
Problème technique | Contacter le support Lemonway |
gateway.invalid-credentials |
Problème technique | Contacter le support Lemonway |
gateway.invalid-merchant |
Problème technique | Contacter le support Lemonway |
gateway.forbidden |
Problème technique | Contacter le support Lemonway |
gateway.not-allowed |
Problème technique | Contacter le support Lemonway |
gateway.internal-error |
Problème technique | Contacter le support Lemonway |
gateway.maintenance |
Problème technique | Contacter le support Lemonway |
gateway.network-error |
Problème technique | Contacter le support Lemonway |
gateway.timeout |
Problème technique | Contacter le support Lemonway |
gateway.unknown-error |
Problème technique | Contacter le support Lemonway |
gateway.duplicate |
La transaction est un doublon ou a déjà été traitée | Vérifier si la transaction a déjà été traitée |
gateway.expired |
Gateway expiré | Contacter le support Lemonway |
gateway.limit-exceeded |
Limite Gateway dépassée | Contacter le support Lemonway |
gateway.rate-limit-exceeded |
Limite de débit Gateway dépassée | Contacter le support Lemonway |
gateway.validation-error |
Problème technique | Contacter le support Lemonway |
gateway.not-found |
Gateway introuvable | Contacter le support Lemonway |
gateway.transaction-not-found |
Transaction introuvable | Contacter le support Lemonway |
gateway.transaction-pending |
Transaction en attente | Attendre la mise à jour du statut |
gateway.unsupported-country-code |
Code pays non supporté | Contacter le support Lemonway |
gateway.unsupported-currency |
Devise non supportée par le Gateway | Contacter le support Lemonway |
gateway.invalid-billing-address |
Adresse de facturation invalide | Vérifier l'adresse de facturation |
gateway.invalid-state |
État de transaction invalide | Contacter le support Lemonway |
gateway.invalid-repeat |
Transaction répétée invalide | Contacter le support Lemonway |
gateway.retry |
Transaction à relancer | Relancer la transaction |
🪫 Statut & Limites de carte
| Code d'erreur | Description | Action recommandée |
|---|---|---|
card.expired |
Carte expirée | Demander au client une nouvelle carte |
card.not-activated |
Carte non encore activée | Demander au client d'activer sa carte |
card.inactive |
Carte inactive | Demander au client de contacter sa banque |
card.restricted |
Carte restreinte | Demander au client de contacter sa banque |
card.revoked |
Carte révoquée — ne pas relancer | Ne pas relancer |
card.revoked-all |
Toutes les cartes du porteur ont été révoquées | Ne pas relancer |
card.exceeded-limits |
Plafond de la carte atteint | Demander au client de contacter sa banque |
card.exceeded-withdrawal-limit |
Plafond de retrait atteint | Demander au client de contacter sa banque |
card.exceeded-activity-limits |
Plafond d'activité atteint | Demander au client de contacter sa banque |
card.exceeded-maximum-amount |
Montant maximum dépassé | Fractionner la transaction ou demander un autre moyen de paiement |
card.no-money |
Fonds insuffisants | Demander au client de recharger son compte |
card.no-credit-account |
Pas de compte crédit associé | Demander un autre moyen de paiement |
card.no-savings-account |
Pas de compte épargne associé | Demander un autre moyen de paiement |
🔐 Authentification & 3DS
| Code d'erreur | Description | Action recommandée |
|---|---|---|
card.needs-authentication |
Authentification 3DS requise | Contacter le support Lemonway |
card.missing-3ds |
Vérification 3DS manquante mais obligatoire | Contacter le support Lemonway |
card.unsupported-3ds |
La carte ne supporte pas le 3DS (mais requis) | Inviter le porteur à contacter sa banque ou utiliser une autre carte |
card.failed-3ds |
Échec de la vérification 3DS | Demander au client de recommencer |
card.expired-3ds |
Vérification 3DS expirée | Demander au client de recommencer |
card.couldnt-3ds |
Authentification 3DS impossible à effectuer | Contacter le support Lemonway |
card.failed-3ds-technical |
Défaillance technique lors du 3DS | Relancer ultérieurement |
card.unsupported-3ds2 |
3DS2 non supporté par la carte | Inviter le porteur à contacter sa banque ou utiliser une autre carte |
card.invalid-eci |
Indicateur de commerce électronique (ECI) invalide | Contacter le support Lemonway |
card.eci-conflict |
Conflit ECI | Contacter le support Lemonway |
card.invalid-pares |
Réponse d'authentification de paiement (PARes) invalide | Contacter le support Lemonway |
🔑 Vérification CVC
| Code d'erreur | Description | Action recommandée |
|---|---|---|
card.failed-cvc |
Échec de la vérification du CVC | Demander au client de vérifier son code CVC |
🎭 États spéciaux de carte
| Code d'erreur | Description | Action recommandée |
|---|---|---|
card.duplicate |
Forte probabilité de doublon | Vérifier si la transaction a déjà été traitée |
card.maximum-attempts |
Nombre maximal de tentatives atteint | Demander au client de contacter sa banque |
card.not-supported |
Carte non supportée | Demander un autre moyen de paiement |
card.already-blocked |
Carte déjà bloquée | Demander au client de contacter sa banque |
card.already-captured |
Transaction déjà capturée | Ne pas relancer |
card.already-refused |
Transaction déjà refusée | Ne pas relancer |
card.pending |
Transaction en attente | Attendre la mise à jour du statut |
card.timeout |
Délai de la transaction dépassé | Relancer la transaction |
card.transaction-not-processed |
Transaction non traitée | Contacter le support Lemonway |
card.contact-acquirer |
Contacter l'acquéreur | Contacter le support Lemonway |
card.contact-bank |
Le client doit contacter sa banque | Demander au client de contacter sa banque |
card.canceled-by-client |
Transaction annulée par le client | Aucune action requise |
card.approve-after-identification |
Identification complémentaire requise | Demander au client de contacter sa banque |
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é | Inviter le porteur à contacter sa banque ou utiliser une autre carte |
card.terminal-not-found |
Terminal introuvable | Contacter le support Lemonway |
card.terminal-not-initialized |
Terminal non initialisé | Contacter le support Lemonway |
card.physical-authentication-error |
Erreur d'authentification physique | Contacter le support Lemonway |
card.no-cheque-account |
Pas de compte chèque associé | Demander un autre moyen de paiement |
card.invalid-bank-country-code |
Code pays bancaire invalide | Contacter le support Lemonway |
🔒 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 | Contacter le support Lemonway |
card.authorization-revoked |
L'autorisation de la transaction a été révoquée | Ne pas relancer |
card.law-violation |
La transaction enfreint des dispositions légales | Ne pas relancer |
card.holder-not-authorized |
Porteur de carte non autorisé | Demander au client de contacter sa banque |
card.not-registered |
Carte non encore enregistrée | Demander au client d'enregistrer sa carte |
card.terminal-not-allowed |
Carte non autorisée sur ce terminal | Contacter le support Lemonway |
card.surcharge-not-allowed |
Supplément non autorisé | Contacter le support Lemonway |
card.surcharge-not-supported |
Supplément non supporté par la carte | Contacter le support Lemonway |
card.exemption-declined |
Exemption refusée | Contacter le support Lemonway |
card.reauthorization-not-allowed |
Réautorisation non permise | Ne pas relancer |
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 ?
- 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