Portefeuilles numériques

Les portefeuilles numériques permettent aux clients de payer en un seul clic avec les moyens de paiement enregistrés sur leurs appareils. Ils offrent de meilleurs taux de conversion, une sécurité renforcée grâce à la tokenisation et une expérience de paiement simplifiée.

Portefeuilles pris en charge

Portefeuille	Disponibilité	Devises	Abonnements	Configuration requise
Apple Pay	Mondiale (sauf Inde)	Toutes	Oui	Vérification du domaine
Google Pay	Mondiale (sauf Inde)	Toutes	Oui	Aucune
Amazon Pay	Mondiale (sauf Inde)	USD	Non	Aucune
Cash App Pay	États-Unis uniquement	USD	Non	Aucune
RevolutPay	Mondiale	GBP	Non	Aucune

Prise en charge de PayPal suspendue : PayPal est temporairement indisponible pour les nouvelles transactions.

Apple Pay

Apple Pay permet aux clients de payer avec les cartes enregistrées dans leur Apple Wallet, avec une authentification Face ID ou Touch ID.

Apple Pay est proposé pour les abonnements même lorsque le premier prélèvement est de **0

** (par exemple, pendant les essais gratuits), afin que le mandat de paiement puisse être configuré lors de l'inscription. Pour les paiements ponctuels, Apple Pay est affiché uniquement lorsque le montant est supérieur à 0

Exigences

Appareils : iOS 17+, iPadOS 17+, Safari 17+ sur macOS
Protocole : HTTPS requis
Domaine : Doit être vérifié auprès d’Apple

Vérification du domaine

La vérification du domaine est requise uniquement pour le paiement intégré (embedded). Le paiement en overlay, le paiement hébergé et les liens de paiement n’en ont pas besoin.

Open Wallet domains

Dans votre dashboard, accédez à Settings → Payment Methods puis, sur la ligne Apple Pay, cliquez sur Manage domains.

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

Download the domain association file

Depuis le panneau des domaines de portefeuille, téléchargez le fichier d’association.

Panneau des domaines de portefeuille avec le bouton Download file — Download the Apple Pay domain association file

Cliquez sur Register domain et 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

Téléversez-le sur votre serveur à l’adresse suivante :

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

Le fichier doit être servi via HTTPS, être accessible sans redirection et être servi 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 envoie 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 indique Active, Apple Pay est actif pour ce domaine. Utilisez le bouton bascule Enabled pour l’activer ou le désactiver pour chaque domaine.

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

Test the integration

Ouvrez le paiement sur un appareil Apple
Vérifiez que le bouton Apple Pay s’affiche
Effectuez une transaction de test

Configuration

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_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, grâce à une protection intégrée contre la fraude.

Exigences

Navigateurs : Chrome (ordinateur/mobile), Safari, Firefox
Appareils : appareils Android équipés de l’application Google Pay
Paramètres : l’option “Allow sites to check if you have payment methods” doit être activée dans Chrome

Configuration

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

Aucune vérification du domaine n’est nécessaire pour Google Pay : le service fonctionne automatiquement une fois votre compte actif.

Amazon Pay

Amazon Pay permet aux clients d’utiliser les identifiants de leur compte Amazon et leurs moyens de paiement enregistrés pour une expérience de paiement familière.

Limitations

Devise : USD uniquement
Abonnements : non pris en charge
Région : indisponible en Inde

Configuration

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

Cash App Pay

Cash App Pay permet d’effectuer des paiements depuis Cash App, très populaire auprès des consommateurs américains pour les paiements entre particuliers.

Limitations

Région : États-Unis uniquement
Devise : USD uniquement
Abonnements : non pris en charge

Configuration

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

RevolutPay

RevolutPay permet aux utilisateurs de Revolut du monde entier d’effectuer des paiements rapides et fluides, en utilisant le solde existant de leur compte Revolut ou leurs cartes associées.

Limitations

Devise : GBP uniquement
Abonnements : non pris en charge

Configuration

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

Tests

Tests avec Apple Pay

Use test mode

Activez le mode test dans votre dashboard Dodo Payments.

Add a card to Apple Wallet

Ajoutez une carte réelle à votre Apple Wallet. En mode test, la carte ne sera pas débitée.

Complete test purchase

Ouvrez le paiement sur un appareil Apple et terminez le parcours Apple Pay.

Apple Pay nécessite HTTPS. Il ne s’affichera pas sur localhost sans configuration SSL appropriée.

Tests avec Google Pay

Join the test card group

Rejoignez le groupe de cartes de test Google Pay pour ajouter automatiquement des cartes de test à votre portefeuille.

Enable test mode

Utilisez vos clés API de test Dodo Payments.

Complete 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 de test et suivez le parcours de paiement standard. Les transactions de test seront simulées sans débit réel.

Prise en charge des SDK

SDK Web

Tous les portefeuilles numériques sont entièrement pris en charge dans :

Overlay Checkout
Inline Checkout
intégration API directe

SDK mobiles (Checkout)

Les SDK Checkout Android, iOS, React Native et Flutter ouvrent le checkout hébergé de Dodo dans la véritable surface de navigateur de la plateforme (SFSafariViewController / Chrome Custom Tabs), et non dans une WebView, de sorte qu’Apple Pay et Google Pay fonctionnent de la même manière que sur le web. Consultez le Guide d’intégration mobile pour la configuration.

Bonnes pratiques

Prioritize wallets on mobile

Les utilisateurs mobiles s’attendent à pouvoir utiliser Apple Pay et Google Pay. Affichez ces options bien en évidence dans les checkouts mobiles.

Complete domain verification early

Apple Pay nécessite la vérification du domaine. N’attendez pas le jour du lancement — commencez le processus pendant le développement.

Always include card fallbacks

Tous les clients ne disposent pas de portefeuilles numériques. Incluez toujours credit et debit dans vos méthodes autorisées.

Test on real devices

Les simulateurs ne reproduisent pas entièrement le comportement des portefeuilles. Effectuez des tests sur de véritables appareils iOS et Android avant le lancement.

Handle wallet unavailability gracefully

Si un portefeuille n’est pas disponible (appareil inadéquat, aucune carte enregistrée), assurez-vous que les autres options de paiement sont visibles.

Dépannage

Apple Pay button not appearing

Vérifications :

Domaine vérifié avec Dodo Payments ?
Utilisation de HTTPS ?
L’appareil est-il sous iOS 17+ / Safari 17+ / iPadOS 17+ ?
Le client possède-t-il des cartes dans Apple Wallet ?
apple_pay est-il inclus dans allowed_payment_method_types ?

Solution : Terminez la vérification du domaine et assurez-vous d’utiliser HTTPS. Effectuez des tests sur un véritable appareil Apple.

Google Pay button not appearing

Vérifications :

Utilisation de Chrome ou d’un navigateur compatible ?
Le client possède-t-il des cartes dans Google Pay ?
Le paramètre Chrome « Autoriser les sites à vérifier les méthodes de paiement » est-il activé ?
google_pay est-il inclus dans allowed_payment_method_types ?

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

Wallet payment failed

Causes courantes :

Carte du portefeuille expirée ou invalide
Transaction refusée par la banque
Problème de connectivité réseau

Solution : Le client doit vérifier la carte dans son portefeuille ou essayer une autre méthode de paiement.

Wrong device type

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

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

Solution : Ce comportement est attendu. Assurez-vous que des solutions de repli pour les cartes sont disponibles.

Pages associées

Payment Methods Overview

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

Overlay Checkout

Implémentez le checkout avec la prise en charge des portefeuilles numériques.

Testing Process

Consultez le guide complet de test pour toutes les méthodes de paiement.

Mobile Integration Guide

Ouvre le checkout hébergé dans un onglet de navigateur natif — Apple Pay et Google Pay fonctionnent de la même manière que sur le web.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Portefeuilles pris en charge

Apple Pay

Exigences

Vérification du domaine

Configuration

Google Pay

Exigences

Configuration

Amazon Pay

Limitations

Configuration

Cash App Pay

Limitations

Configuration

RevolutPay

Limitations

Configuration

Tests

Tests avec Apple Pay

Tests avec 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

​Exigences

​Vérification du domaine

​Configuration

​Google Pay

​Exigences

​Configuration

​Amazon Pay

​Limitations

​Configuration

​Cash App Pay

​Limitations

​Configuration

​RevolutPay

​Limitations

​Configuration

​Tests

​Tests avec Apple Pay

​Tests avec 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

Exigences

Vérification du domaine

Configuration

Google Pay

Exigences

Configuration

Amazon Pay

Limitations

Configuration

Cash App Pay

Limitations

Configuration

RevolutPay

Limitations

Configuration

Tests

Tests avec Apple Pay

Tests avec 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