Méthodes de paiement européennes - Dodo Payments Documentation

Acceptez iDEAL, Bancontact, EPS, Multibanco, BLIK, SEPA Direct Debit et Satispay pour atteindre les clients européens qui préfèrent payer depuis leur banque ou une application de paiement locale plutôt qu’avec une carte. Sur les marchés où une méthode locale est le moyen le plus courant de payer en ligne, la proposer peut augmenter le taux de conversion.

Pourquoi des méthodes de paiement locales européennes ?

Higher Conversion

iDEAL est la méthode de paiement en ligne la plus utilisée aux Pays-Bas. Sans elle, vous perdez les clients néerlandais qui ne paieront pas autrement.

Bank Authentication

Pour les méthodes authentifiées par la banque, le client approuve le paiement dans son application bancaire ou sur le site de sa banque.

Real-Time Settlement

La plupart des méthodes présentées sur cette page confirment le paiement pendant le checkout. SEPA Direct Debit et les paiements Multibanco par DAB sont confirmés ultérieurement.

Méthodes prises en charge

Chaque méthode est proposée uniquement lorsque le checkout correspond à sa devise et à son type de facturation :

Méthode	Pays	Devise	Abonnements
iDEAL	Pays-Bas	EUR	Non
Bancontact	Belgique	EUR	Non
EPS	Autriche	EUR	Non
Multibanco	Portugal	EUR	Non
BLIK	Pologne	PLN	Non
SEPA Direct Debit	Zone euro	EUR	Oui
Satispay	Europe (Italie)	EUR	Oui

iDEAL (Pays-Bas)

iDEAL est la méthode de paiement en ligne la plus utilisée aux Pays-Bas. Elle se connecte directement à toutes les grandes banques néerlandaises, et le client approuve chaque paiement avec sa propre banque.

Fonctionnement

Le client sélectionne iDEAL, choisit sa banque, puis s’y authentifie :

Banques prises en charge

iDEAL fonctionne avec toutes les grandes banques néerlandaises, notamment :

ABN AMRO
ASN Bank
Bunq
ING
Knab
Rabobank
RegioBank
Revolut
SNS
Triodos Bank
Van Lanschot

Configuration

Pour proposer iDEAL, incluez ideal dans allowed_payment_method_types et facturez en EUR :

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['ideal', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'NL',
    zipcode: '1012JS'
  },
  return_url: 'https://example.com/success'
});

Bancontact (Belgique)

Bancontact est le système de paiement national belge. Presque toutes les banques belges l’utilisent pour les paiements en ligne.

Fonctionnalités

Fonctionne avec les cartes de débit Bancontact que les clients belges possèdent déjà
Prend en charge le paiement dans l’application mobile Bancontact
Confirme le paiement pendant le checkout
Ne nécessite aucune inscription supplémentaire de la part du client

Configuration

Pour proposer Bancontact, incluez bancontact_card et facturez en EUR :

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['bancontact_card', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'BE',
    zipcode: '1000'
  },
  return_url: 'https://example.com/success'
});

EPS (Autriche)

EPS (Electronic Payment Standard) permet aux clients autrichiens de payer par virement bancaire en ligne depuis leur propre banque.

Fonctionnalités

Se connecte directement aux banques autrichiennes
Confirme le paiement pendant le checkout
Bénéficie d’une grande confiance auprès des consommateurs autrichiens

Banques prises en charge

EPS fonctionne avec les grandes banques autrichiennes, notamment :

Erste Bank
Bank Austria
Raiffeisen
BAWAG
Volksbank

Configuration

Pour proposer EPS, incluez eps et facturez en EUR :

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['eps', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'AT',
    zipcode: '1010'
  },
  return_url: 'https://example.com/success'
});

Multibanco (Portugal)

Multibanco est le réseau interbancaire portugais. Les clients peuvent payer en ligne ou régler une référence de paiement à un distributeur automatique.

Options de paiement

Les clients peuvent effectuer un paiement Multibanco de trois façons :

Banque en ligne : un virement bancaire effectué via la banque en ligne du client.
Paiement au distributeur : le client reçoit une référence de paiement et la règle à n’importe quel distributeur Multibanco.
Banque mobile : un paiement effectué dans l’application bancaire du client.

Fonctionnement du paiement au distributeur

Pour un paiement au distributeur, le client reçoit une référence de paiement comme celle-ci :

Entity: 12345
Reference: 123 456 789
Amount: €50.00

Le client paie avec cette référence à n’importe quel distributeur portugais ou via la banque en ligne. La référence est valide pendant une durée limitée, indiquée au client avec la référence.

Configuration

Pour proposer Multibanco, incluez multibanco et facturez en EUR :

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['multibanco', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'PT',
    zipcode: '1000-001'
  },
  return_url: 'https://example.com/success'
});

Un paiement Multibanco au distributeur est finalisé lorsque le client règle la référence, ce qui peut se produire longtemps après le checkout. Utilisez des webhooks pour savoir quand le paiement est confirmé.

BLIK (Pologne)

BLIK est la méthode de paiement mobile la plus populaire en Pologne. Le client paie avec un code unique à 6 chiffres qu’il génère dans son application bancaire. Les paiements BLIK sont facturés en PLN (zloty polonais), et non en EUR.

Fonctionnement

Le client génère un code dans son application bancaire, le saisit lors du checkout, puis approuve le paiement dans l’application :

Disponibilité

Devise de facturation : PLN uniquement
Type de transaction : paiements ponctuels uniquement. BLIK n’est pas proposé pour les abonnements.
Couverture : toutes les grandes banques polonaises prenant en charge BLIK

Configuration

Pour proposer BLIK, incluez blik et définissez billing_currency sur PLN :

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['blik', 'credit', 'debit'],
  billing_currency: 'PLN',
  billing_address: {
    country: 'PL',
    zipcode: '00-001'
  },
  return_url: 'https://example.com/success'
});

BLIK nécessite une devise de facturation en PLN, et Dodo Payments facture en PLN uniquement lorsque Adaptive Currency est activé. Activez Adaptive Currency afin que les clients polonais soient facturés en PLN et que BLIK soit disponible.

SEPA Direct Debit (zone euro)

SEPA Direct Debit permet aux clients de la zone euro de payer depuis leur compte bancaire plutôt qu’avec une carte. Il est proposé pour les checkouts en EUR, pour les paiements ponctuels comme pour les abonnements, lorsque le pays de facturation est l’Autriche, la Belgique, l’Estonie, la Finlande, la France, l’Allemagne, l’Irlande, l’Italie, la Lettonie, la Lituanie, les Pays-Bas, le Portugal, la Slovaquie ou l’Espagne.

SEPA Direct Debit n’est pas instantané. La confirmation d’un paiement peut prendre jusqu’à 6 jours ouvrés. Contrairement à un paiement par carte, l’autorisation du client lors du checkout ne signifie pas que les fonds ont été compensés. N’exécutez pas la commande lors de la redirection du checkout ni sur payment.processing. Attendez le webhook payment.succeeded.

Fonctionnement

Le client autorise le prélèvement lors du checkout, puis Dodo Payments collecte les fonds sur son compte bancaire. La banque compense le prélèvement de manière asynchrone ; le paiement reste donc dans l’état processing jusqu’à atteindre un résultat final :

Chronologie du paiement

Un paiement SEPA passe par les étapes suivantes :

Étape	Quand	Statut du paiement	Signification
Autorisation	Lors du checkout	`processing`	Le client a approuvé le prélèvement et a été redirigé. Les fonds n’ont pas encore été transférés : n’exécutez donc pas la commande.
Confirmation	Jusqu’à 6 jours ouvrés plus tard	`succeeded`	La banque a compensé le prélèvement. Exécutez maintenant la commande.
Échec	Jusqu’à 6 jours ouvrés plus tard	`failed`	Le prélèvement n’a pas pu être collecté, par exemple en raison de fonds insuffisants. N’exécutez pas la commande et informez le client.

La confirmation arrive plusieurs jours après que le client a quitté votre site. Votre gestionnaire de webhooks, et non la redirection du checkout, doit donc accorder l’accès. Consultez Gestion du délai de confirmation.

Disponibilité

Devise de facturation : EUR
Type de transaction : paiements ponctuels et abonnements

Configuration

Pour proposer SEPA Direct Debit, incluez sepa et facturez en EUR :

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['sepa', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'DE',
    zipcode: '10115'
  },
  return_url: 'https://example.com/success'
});

IBAN de test SEPA

En mode test, saisissez l’un de ces IBAN lors du checkout pour forcer un résultat spécifique :

IBAN de test	Comportement
`DE89370400440532013000`	Le paiement réussit.
`DE08370400440532013003`	Le paiement réussit après un délai d’au moins trois minutes.
`DE62370400440532013001`	Le paiement échoue.
`DE78370400440532013004`	Le paiement échoue après un délai d’au moins trois minutes.
`DE35370400440532013002`	Le paiement réussit, puis est immédiatement contesté.
`DE65370400440002222227`	Le paiement échoue en raison de fonds insuffisants.
`DE18370400440000066666`	Le compte bancaire est inutilisable ; la méthode de paiement ne peut donc pas être créée.

Pour tester le comportement propre à un pays, utilisez l’IBAN de réussite d’un autre pays de la zone euro :

Pays	IBAN de réussite
Autriche	`AT611904300234573201`
Belgique	`BE62510007547061`
Estonie	`EE382200221020145685`
Finlande	`FI2112345600000785`
France	`FR1420041010050500013M02606`
Irlande	`IE29AIBK93115212345678`
Luxembourg	`LU280019400644750000`

Utilisez les IBAN de test différé pour confirmer que votre gestionnaire de webhooks, et non la redirection du checkout, accorde l’accès. Les paiements SEPA sont confirmés longtemps après que le client a quitté le checkout.

Gestion du délai de confirmation

SEPA est réglé jusqu’à 6 jours ouvrés après le checkout ; la redirection du navigateur ne peut donc pas vous indiquer si le paiement a été compensé. Déclenchez l’exécution de la commande à partir des événements webhook. Activez l’événement type et gérez chaque étape :

Type d’événement	Déclenchement	Action
`payment.processing`	Le client a autorisé le prélèvement lors du checkout et a été redirigé.	N’exécutez pas la commande. Marquez-la comme en attente. Vous pouvez indiquer au client que son paiement est en cours de traitement.
`payment.succeeded`	La banque a compensé le prélèvement, jusqu’à 6 jours ouvrés plus tard.	Exécutez la commande : accordez l’accès, provisionnez le produit et envoyez le reçu.
`payment.failed`	Le prélèvement n’a pas pu être collecté.	Informez le client et invitez-le à réessayer. N’exécutez pas la commande.

Exécutez la commande sur payment.succeeded depuis le webhook, et non lors de la redirection du checkout ou sur payment.processing. La redirection se produit dès que le client autorise le prélèvement, plusieurs jours avant la compensation des fonds.

Le gestionnaire Express suivant vérifie la signature de chaque événement avec client.webhooks.unwrap avant d’agir. Pour configurer le endpoint, consultez le guide Webhooks. Pour connaître tous les événements, consultez le Guide des événements Webhook.

Handling SEPA payment events

import express from 'express';
import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  webhookKey: process.env.DODO_PAYMENTS_WEBHOOK_KEY,
});
const app = express();

// markOrderPending, fulfillOrder, and markOrderFailed are your own order functions.
app.post('/webhooks/dodo', express.raw({ type: 'application/json' }), async (req, res) => {
  let event;
  try {
    // Checks the webhook-id, webhook-signature, and webhook-timestamp headers.
    event = client.webhooks.unwrap(req.body.toString(), { headers: req.headers });
  } catch {
    return res.status(400).send('Invalid signature');
  }

  switch (event.type) {
    case 'payment.processing': {
      // SEPA debit authorized but NOT settled. This can last up to 6 business days.
      // Record the order as pending; do not grant access yet.
      await markOrderPending(event.data.payment_id);
      break;
    }
    case 'payment.succeeded': {
      // The debit cleared, so it's safe to fulfill now.
      await fulfillOrder(event.data.payment_id);
      break;
    }
    case 'payment.failed': {
      // The debit could not be collected (for example, insufficient funds).
      await markOrderFailed(event.data.payment_id);
      // Notify the customer and prompt a retry.
      break;
    }
  }

  res.json({ received: true });
});

Définissez les attentes du client lors du checkout. L’accès n’est accordé qu’après la compensation du prélèvement ; indiquez donc aux clients SEPA que leur commande est en cours de traitement et que vous les informerez lorsque le paiement sera confirmé. Sinon, ils peuvent s’attendre à un accès immédiat, comme avec un paiement par carte.

Satispay (Europe)

Satispay est un réseau européen de paiement mobile dont la plus grande base d’utilisateurs se trouve en Italie. Les clients paient depuis l’application Satispay sans partager leurs coordonnées bancaires ou de carte. Les paiements Satispay sont facturés en EUR.

Fonctionnalités

Paiements via une application qui ne dépendent pas des réseaux de cartes
Forte adoption en Italie et usage croissant sur d’autres marchés européens
Prise en charge des paiements ponctuels et des abonnements

Disponibilité

Devise de facturation : EUR
Type de transaction : paiements ponctuels et abonnements
Montant : de 0,50 € à 999 999,99 € par paiement

Configuration

Pour proposer Satispay, incluez satispay et facturez en EUR :

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['satispay', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'IT',
    zipcode: '00100'
  },
  return_url: 'https://example.com/success'
});

Types de méthodes API

Transmettez ces valeurs dans allowed_payment_method_types :

Type	Méthode	Pays
`ideal`	iDEAL	Pays-Bas
`bancontact_card`	Bancontact	Belgique
`eps`	EPS	Autriche
`multibanco`	Multibanco	Portugal
`blik`	BLIK	Pologne
`sepa`	SEPA Direct Debit	Zone euro
`satispay`	Satispay	Europe (Italie)

Checkout européen multi-pays

Pour vendre dans plusieurs pays européens, incluez chaque méthode régionale, ainsi que les cartes comme solution de secours :

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: [
    'ideal',           // Netherlands
    'bancontact_card', // Belgium
    'eps',             // Austria
    'multibanco',      // Portugal
    'blik',            // Poland (requires PLN billing currency)
    'sepa',            // Eurozone (one-time payments and subscriptions)
    'satispay',        // Europe / Italy
    'credit',          // Fallback
    'debit'            // Fallback
  ],
  billing_currency: 'EUR',
  return_url: 'https://example.com/success'
});

Dodo Payments n’affiche à chaque client que les méthodes correspondant à son pays de facturation et à sa devise. Un client néerlandais voit iDEAL et un client belge voit Bancontact. Cette session est facturée en EUR ; BLIK n’apparaît donc pas.

Tests

Vous pouvez tester les méthodes de paiement européennes en mode test. Le parcours de test simule l’étape d’authentification bancaire.

SEPA Direct Debit utilise un parcours de test différent. Au lieu d’un parcours bancaire simulé, vous saisissez directement un IBAN de test. Consultez les IBAN de test SEPA.

Enable Test Mode

Désactivez le sélecteur Live Mode dans la barre latérale du dashboard et utilisez les clés API créées en mode test.

Set Appropriate Billing Address

Définissez le pays de l’adresse de facturation pour qu’il corresponde à la méthode de paiement :

NL pour iDEAL
BE pour Bancontact
AT pour EPS
PT pour Multibanco
PL pour BLIK (avec une devise de facturation en PLN)
IT pour Satispay

Complete the Test Flow

Suivez le parcours d’authentification bancaire simulé en mode test.

Bonnes pratiques

Always include regional methods for target markets

Si vous vendez à des clients néerlandais, incluez iDEAL. L’omettre revient à ne pas accepter Visa aux États-Unis : vous perdez une part importante de vos ventes.

Match currency to region

La plupart des méthodes de paiement européennes nécessitent l’EUR ; assurez-vous donc que vos tarifs prennent en charge les transactions en EUR. La seule exception est BLIK, proposé uniquement avec une facturation en PLN (zloty polonais).

Handle redirects gracefully

La plupart des méthodes européennes redirigent le client vers sa banque ou son application de paiement. Assurez-vous que la gestion de votre URL de retour fonctionne pour les clients qui abandonnent le parcours en cours de route.

Provide card fallbacks

Tous les clients en Europe ne peuvent pas utiliser ces méthodes régionales, notamment les touristes et les expatriés. Incluez credit et debit comme solutions de secours. Si aucune méthode n’est disponible, la session de checkout échoue.

Consider Multibanco timing

Un paiement Multibanco au distributeur peut prendre plusieurs heures. Ne bloquez pas l’exécution de la commande en attendant un paiement immédiat. Utilisez des webhooks pour la confirmation asynchrone.

Account for the SEPA 6-day delay

SEPA Direct Debit peut prendre jusqu’à 6 jours ouvrés pour être confirmé. N’exécutez pas la commande lors de la redirection du checkout ni sur payment.processing. Accordez l’accès uniquement depuis le webhook payment.succeeded et indiquez aux clients lors du checkout que leur commande est en attente. Consultez Gestion du délai de confirmation.

Dépannage

European method not appearing

Vérifiez :

Le pays de facturation du client correspond-il au pays de la méthode ?
La devise de facturation est-elle EUR, ou PLN pour BLIK ?
La méthode est-elle incluse dans allowed_payment_method_types ?
Le checkout concerne-t-il un paiement ponctuel ? iDEAL, Bancontact, EPS, Multibanco et BLIK ne sont pas proposés pour les abonnements.

Solution : Les méthodes propres à un pays n’apparaissent que pour ce pays. Un client dont le pays de facturation est DE (Allemagne) ne voit pas iDEAL, réservé aux Pays-Bas.

Bank authentication failed

Causes :

Le client a annulé pendant l’authentification bancaire.
Le système d’authentification de la banque était temporairement indisponible.
Le client a saisi des identifiants incorrects.

Solution : Le client doit réessayer. Si l’échec persiste, suggérez une autre méthode de paiement.

Redirect not completing

Causes :

Le client a fermé le navigateur pendant la redirection bancaire.
Un problème réseau a interrompu l’authentification.
L’URL de retour est mal configurée.

Solution : Vérifiez que votre URL de retour est correcte et accessible, et qu’elle gère les états de réussite comme d’échec.

Multibanco payment pending

Cause : Le client a reçu une référence de paiement, mais ne l’a pas encore réglée.Solution : Ce comportement est attendu pour les paiements au distributeur. Attendez la confirmation du webhook. La référence expire après la durée limitée indiquée au client.

SEPA payment stuck in processing

Cause : SEPA Direct Debit est compensé de manière asynchrone par la banque du client.Solution : Ce comportement est attendu. Un état payment.processing peut durer jusqu’à 6 jours ouvrés avant la compensation du prélèvement. Attendez le webhook final payment.succeeded (exécuter la commande) ou payment.failed (ne pas exécuter la commande). Ne considérez pas la redirection du checkout comme une confirmation. Consultez Gestion du délai de confirmation.

Pages associées

Payment Methods Overview

Consultez toutes les méthodes de paiement prises en charge.

Adaptive Currency

Prise en charge des devises et conversion automatique.

Checkout Guide

Guide complet de mise en œuvre du checkout.

Webhooks

Gérez les confirmations de paiement de manière asynchrone.

​Pourquoi des méthodes de paiement locales européennes ?

Higher Conversion

Bank Authentication

Real-Time Settlement

​Méthodes prises en charge

​iDEAL (Pays-Bas)

​Fonctionnement

​Banques prises en charge

​Configuration

​Bancontact (Belgique)

​Fonctionnalités

​Configuration

​EPS (Autriche)

​Fonctionnalités

​Banques prises en charge

​Configuration

​Multibanco (Portugal)

​Options de paiement

​Fonctionnement du paiement au distributeur

​Configuration

​BLIK (Pologne)

​Fonctionnement

​Disponibilité

​Configuration

​SEPA Direct Debit (zone euro)

​Fonctionnement

​Chronologie du paiement

​Disponibilité

​Configuration

​IBAN de test SEPA

​Gestion du délai de confirmation

​Satispay (Europe)

​Fonctionnalités

​Disponibilité

​Configuration

​Types de méthodes API

​Checkout européen multi-pays

​Tests

​Bonnes pratiques

​Dépannage

​Pages associées

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

Pourquoi des méthodes de paiement locales européennes ?

Méthodes prises en charge

iDEAL (Pays-Bas)

Fonctionnement

Banques prises en charge

Configuration

Bancontact (Belgique)

Fonctionnalités

Configuration

EPS (Autriche)

Fonctionnalités

Banques prises en charge

Configuration

Multibanco (Portugal)

Options de paiement

Fonctionnement du paiement au distributeur

Configuration

BLIK (Pologne)

Fonctionnement

Disponibilité

Configuration

SEPA Direct Debit (zone euro)

Fonctionnement

Chronologie du paiement

Disponibilité

Configuration

IBAN de test SEPA

Gestion du délai de confirmation

Satispay (Europe)

Fonctionnalités

Disponibilité

Configuration

Types de méthodes API

Checkout européen multi-pays

Tests

Bonnes pratiques

Dépannage

Pages associées