Portefeuilles numériques

Les portefeuilles numériques permettent aux clients de payer avec une carte ou un compte déjà enregistré sur leur appareil, sans saisir les informations de leur carte. Le portefeuille envoie un jeton au lieu du numéro de carte, puis le client confirme le paiement d’une pression ou d’une vérification biométrique.

Portefeuilles pris en charge

Dodo Payments affiche chaque portefeuille uniquement lorsque le paiement correspond à son pays, sa devise et son type de paiement :

Wallet	Disponibilité	Devises	Abonnements	Configuration requise
Apple Pay	Mondiale (sauf Inde)	Toutes	Oui	Vérification du domaine pour le paiement intégré
Google Pay	Mondiale (sauf Inde)	Toutes	Oui	Aucune
Amazon Pay	Mondiale (sauf Inde)	USD, EUR, GBP, AUD, CHF, DKK, HKD, JPY, NOK, NZD, SEK, ZAR	Non	Aucune
Cash App Pay	États-Unis uniquement	USD	Oui	Aucune
RevolutPay	Mondiale	GBP	Non	Aucune

PayPal est temporairement indisponible pour les nouvelles transactions.

Apple Pay

Apple Pay permet aux clients de payer avec les cartes enregistrées dans Apple Wallet et de confirmer avec Face ID ou Touch ID.

Apple Pay apparaît pour les abonnements même lorsque le premier prélèvement est de $0, par exemple lors d’un essai gratuit, afin que le mandat de paiement soit configuré lors de l’inscription. Pour les paiements ponctuels, Apple Pay apparaît uniquement lorsque le montant est supérieur à $0.

Conditions requises

Appareils : iOS 17 ou version ultérieure, iPadOS 17 ou version ultérieure, ou Safari 17 ou version ultérieure sur macOS.
Protocole : La page doit être chargée via HTTPS.
Domaine : Pour le paiement intégré, le domaine doit être vérifié avec Apple.

Vérification du domaine

La vérification du domaine est requise uniquement pour le paiement intégré (embedded). Le paiement hébergé et les liens de paiement affichent Apple Pay sans cette vérification.

Apple Pay n’est pas disponible dans le paiement en superposition. Pour proposer Apple Pay, utilisez le paiement intégré, le paiement hébergé ou un lien de paiement.

Pour vérifier un domaine pour le paiement intégré, suivez ces étapes dans le tableau de bord :

Open Apple Pay Domains

Accédez à Settings → Payment Methods. Sur la ligne Apple Pay, cliquez sur Manage domains.

Bouton Manage domains sur la ligne Apple Pay dans les paramètres Payment Methods — Open Apple Pay domains from the Apple Pay row

Download the Domain Association File

Dans le panneau Apple Pay domains, cliquez sur Download file.

Panneau Apple Pay domains avec le bouton Download file — Download the Apple Pay domain association file

Cliquez sur Register domain, saisissez le domaine où vous intégrez le paiement (par exemple, shop.example.com), puis cliquez sur Continue.

Formulaire d’enregistrement d’un domaine avec un domaine saisi — Register the domain where you embed checkout

Host the File on Your Domain

Importez le fichier sur votre serveur à ce chemin :

https://shop.example.com/.well-known/apple-developer-merchantid-domain-association

Servez le fichier via HTTPS, sans redirections, avec Content-Type: application/octet-stream ou text/plain.

Verify the Domain

Cliquez sur Verify domain. Dodo Payments vérifie le fichier hébergé et soumet votre domaine à Apple.

Écran de vérification du domaine avec le chemin d’hébergement du fichier d’association et le bouton Verify domain — Verify the hosted association file

Confirm It's Active

Lorsque le statut affiche Active, Apple Pay est opérationnel sur ce domaine. Pour activer ou désactiver Apple Pay pour un domaine, utilisez son bouton Enabled.

Liste des domaines Apple Pay affichant des domaines avec le statut Active et des boutons Enabled — Verified domains show an Active status

Test the Integration

Ouvrez le paiement sur un appareil Apple.
Vérifiez que le bouton Apple Pay apparaît.
Effectuez une transaction de test.

Configuration

Pour limiter une session de paiement à Apple Pay et aux cartes, transmettez allowed_payment_method_types :

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

Google Pay

Google Pay permet aux clients de payer avec les cartes enregistrées dans leur compte Google.

Conditions requises

Navigateurs : Chrome sur ordinateur et Android, ainsi que Firefox sur ordinateur. Le paiement n’affiche pas Google Pay dans Safari ni dans les navigateurs sur iOS. Sur ces navigateurs, les clients peuvent payer avec Apple Pay ou une carte.
Appareils : Appareils Android équipés de l’application Google Pay.
Paramètres : Dans Chrome, l’option Autoriser les sites à vérifier si vous avez enregistré des modes de paiement doit être activée.

Configuration

Pour limiter une session de paiement à Google Pay et aux cartes, transmettez allowed_payment_method_types :

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

Google Pay ne nécessite aucune vérification du domaine.

Amazon Pay

Amazon Pay permet aux clients de payer avec les moyens de paiement enregistrés dans leur compte Amazon.

Disponibilité

Région : Mondiale, sauf l’Inde.
Devises : USD, EUR, GBP, AUD, CHF, DKK, HKD, JPY, NOK, NZD, SEK, ZAR. Les devises proposées par un paiement dépendent du processeur qui le traite.
Abonnements : Non pris en charge.

Configuration

Pour limiter une session de paiement à Amazon Pay et aux cartes, transmettez allowed_payment_method_types :

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

Cash App Pay

Cash App Pay permet aux clients américains de payer depuis leur compte Cash App.

Disponibilité

Région : États-Unis uniquement. Le pays de facturation doit être les États-Unis.
Devise : USD uniquement.
Abonnements : Pris en charge.

Configuration

Pour limiter une session de paiement à Cash App Pay et aux cartes, transmettez allowed_payment_method_types :

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

RevolutPay

RevolutPay permet aux utilisateurs de Revolut de payer depuis le solde de leur compte Revolut ou avec leurs cartes associées.

Disponibilité

Région : Mondiale.
Devise : GBP uniquement.
Abonnements : Non pris en charge.

Configuration

Pour limiter une session de paiement à RevolutPay et aux cartes, transmettez allowed_payment_method_types :

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

Tests

En mode test, les paiements par portefeuille suivent le même flux de paiement, sans transfert d’argent réel.

Tester Apple Pay

Use Test Mode

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

Add a Card to Apple Wallet

Ajoutez une carte réelle à Apple Wallet. En mode test, la carte n’est pas débitée.

Complete a Test Purchase

Ouvrez le paiement sur un appareil Apple et effectuez le flux Apple Pay.

Apple Pay nécessite HTTPS. Il n’apparaît pas sur localhost si la page n’est pas servie via HTTPS.

Tester Google Pay

Join the Test Card Group

Rejoignez le groupe de cartes de test Google Pay pour que des cartes de test soient ajoutées à votre portefeuille.

Enable Test Mode

Utilisez les clés API créées en mode test.

Complete a Test Purchase

Sélectionnez l’une des cartes de test dans Google Pay pour terminer la transaction.

Amazon Pay et Cash App Pay

Utilisez vos clés API en mode test et suivez le flux de paiement standard. Les transactions de test sont simulées et aucun débit réel n’est effectué.

Prise en charge des SDK

La disponibilité des portefeuilles dépend de la manière dont vous présentez le paiement.

SDK Web

Les portefeuilles numériques fonctionnent dans :

le paiement en superposition, sauf Apple Pay ;
le paiement intégré. Apple Pay nécessite une vérification du domaine ;
l’intégration API directe avec le paiement hébergé.

SDK mobiles (Checkout)

Les SDK de paiement Android, iOS, React Native et Flutter ouvrent le paiement hébergé Dodo Payments dans le navigateur système de la plateforme (SFSafariViewController sur iOS, Chrome Custom Tabs sur Android), et non dans une WebView. Apple Pay et Google Pay y fonctionnent comme sur le Web. Consultez le Guide d’intégration mobile pour la configuration.

Bonnes pratiques

Prioritize wallets on mobile

Les clients mobiles s’attendent à trouver Apple Pay et Google Pay. Affichez ces options bien en évidence dans les paiements mobiles.

Complete domain verification early

Si vous utilisez le paiement intégré, vérifiez votre domaine pour Apple Pay pendant le développement, et non le jour du lancement.

Always include card fallbacks

Tous les clients ne disposent pas d’un portefeuille numérique. Incluez credit et debit dans allowed_payment_method_types.

Test on real devices

Les simulateurs ne reproduisent pas entièrement le comportement des portefeuilles. Testez sur de vrais appareils iOS et Android avant le lancement.

Handle wallet unavailability

Un portefeuille n’apparaît pas sur un appareil non compatible ou lorsque le client n’a aucune carte enregistrée. Laissez les autres moyens de paiement visibles pour ces clients.

Dépannage

Apple Pay button not appearing

Vérification :

Pour le paiement intégré, le domaine est-il vérifié dans Manage domains ?
La page est-elle chargée via HTTPS ?
L’appareil utilise-t-il iOS 17, iPadOS 17 ou Safari 17, ou une version ultérieure ?
Le client possède-t-il des cartes dans Apple Wallet ?
apple_pay est-il inclus dans allowed_payment_method_types ?
Le paiement est-il en superposition ? Apple Pay n’est pas disponible dans le paiement en superposition.

Solution : Effectuez la vérification du domaine et servez la page via HTTPS. Testez sur un véritable appareil Apple.

Apple Pay domain stuck on Pending

Après avoir cliqué sur Verify domain, Dodo Payments récupère le fichier d’association depuis votre domaine et soumet le domaine à Apple. Un domaine qui reste à l’état Pending contient généralement un fichier que Dodo Payments ne parvient pas à récupérer comme prévu.Vérification :

Le fichier est accessible à l’adresse https://<your-domain>/.well-known/apple-developer-merchantid-domain-association.
Il est servi via HTTPS avec un certificat valide.
Il est résolu sans redirections. Une redirection vers www, vers un autre hôte ou vers une page d’erreur échoue à la vérification.
Il est servi en tant que Content-Type: application/octet-stream ou text/plain, et non text/html.
Il s’agit du fichier téléchargé depuis Manage domains pour cette entreprise, et non d’un fichier réutilisé depuis un autre compte ou fournisseur.

Pour confirmer que le fichier est accessible publiquement, demandez l’URL depuis l’extérieur de votre propre réseau, par exemple dans une fenêtre de navigation privée. Les mots de passe de staging, les écrans d’authentification et les règles de pare-feu permettent souvent à la requête d’aboutir pour vous, mais l’empêchent d’aboutir pour Dodo Payments.Solution : Corrigez le problème d’hébergement, puis cliquez à nouveau sur Verify domain. Si le domaine ne passe pas à l’état Active après une vérification réussie, contactez support@dodopayments.com en indiquant le nom du domaine.

Google Pay button not appearing

Vérification :

Le client utilise-t-il un navigateur compatible ? Google Pay n’apparaît pas dans Safari ni dans les navigateurs sur iOS.
Le client a-t-il des cartes dans Google Pay ?
Le paramètre Chrome Autoriser les sites à vérifier si vous avez enregistré des modes de paiement est-il activé ?
Est-ce que google_pay est inclus dans allowed_payment_method_types ?

Solution : Vérifiez le navigateur et la configuration Google Pay du client.

Wallet payment failed

Causes courantes :

La carte du portefeuille a expiré ou n’est pas valide.
La banque a refusé la transaction.
Un problème de connexion réseau a interrompu le paiement.

Solution : Demandez au client de vérifier la carte dans son portefeuille ou d’utiliser un autre moyen de paiement.

Wrong device type

Les portefeuilles numériques apparaissent uniquement sur les appareils compatibles :

Apple Pay : appareils Apple uniquement.
Google Pay : appareils Chrome ou Android.

Solution : Ce comportement est attendu. Gardez les paiements par carte disponibles comme solution de secours.

Pages associées

Payment Methods Overview

Tous les moyens de paiement pris en charge.

Overlay Checkout

Ouvrez le paiement en superposition sur votre page.

Testing Process

Données de test pour chaque moyen de paiement.

Mobile Integration Guide

Ouvrez le paiement hébergé dans le navigateur système, où Apple Pay et Google Pay fonctionnent comme sur le Web.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Portefeuilles pris en charge

Apple Pay

Conditions requises

Vérification du domaine

Configuration

Google Pay

Conditions requises

Configuration

Amazon Pay

Disponibilité

Configuration

Cash App Pay

Disponibilité

Configuration

RevolutPay

Disponibilité

Configuration

Tests

Tester Apple Pay

Tester Google Pay

Amazon Pay et Cash App Pay

Prise en charge des SDK

SDK Web

SDK mobiles (Checkout)

Bonnes pratiques

Dépannage

Pages associées

Payment Methods Overview

Overlay Checkout

Testing Process

Mobile Integration Guide

​Portefeuilles pris en charge

​Apple Pay

​Conditions requises

​Vérification du domaine

​Configuration

​Google Pay

​Conditions requises

​Configuration

​Amazon Pay

​Disponibilité

​Configuration

​Cash App Pay

​Disponibilité

​Configuration

​RevolutPay

​Disponibilité

​Configuration

​Tests

​Tester Apple Pay

​Tester Google Pay

​Amazon Pay et Cash App Pay

​Prise en charge des SDK

​SDK Web

​SDK mobiles (Checkout)

​Bonnes pratiques

​Dépannage

​Pages associées

Payment Methods Overview

Overlay Checkout

Testing Process

Mobile Integration Guide

Portefeuilles pris en charge

Apple Pay

Conditions requises

Vérification du domaine

Configuration

Google Pay

Conditions requises

Configuration

Amazon Pay

Disponibilité

Configuration

Cash App Pay

Disponibilité

Configuration

RevolutPay

Disponibilité

Configuration

Tests

Tester Apple Pay

Tester Google Pay

Amazon Pay et Cash App Pay

Prise en charge des SDK

SDK Web

SDK mobiles (Checkout)

Bonnes pratiques

Dépannage

Pages associées