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 :

Portefeuille	Disponibilité	Devises	Abonnements	Configuration requise
Apple Pay	Mondiale, y compris l’Inde	Toutes, y compris INR	Oui	Vérification du domaine pour le checkout inline
Google Pay	Mondiale (sauf l’Inde)	Toutes	Oui	Aucune
Amazon Pay	Mondiale (sauf l’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. En Inde, Apple exige un iPhone XR ou version ultérieure sous iOS 18 ou version ultérieure.
Protocole : La page doit être chargée via HTTPS.
Domaine : Pour le checkout inline, le domaine doit être vérifié auprès d’Apple.

Apple Pay en Inde

Les clients en Inde peuvent payer avec Apple Pay lors de checkouts facturés en INR. Apple Pay en Inde fonctionne dans les conditions suivantes :

Devise : Le checkout est facturé en INR. Un paiement facturé en INR doit respecter le minimum INR.
Cartes : Le client possède dans Apple Wallet une carte d’une banque indienne prenant en charge Apple Pay. Apple détermine quelles banques et cartes sont éligibles.
Ordinateur : Dans un navigateur sur ordinateur, les clients peuvent scanner un code avec leur iPhone et confirmer le paiement sur leur téléphone.
Abonnements : Les abonnements Apple Pay en INR utilisent les mandats RBI. Chaque prélèvement de renouvellement est effectué environ 48 heures après la date de renouvellement, comme pour les autres cartes émises en Inde.

Pour facturer un client en Inde en INR, suivez les exigences relatives au Payment Methods en Inde concernant le pays de facturation et Adaptive Currency.

Vérification du domaine

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

Apple Pay n’est pas disponible dans le checkout en overlay. Pour proposer Apple Pay, utilisez le checkout inline, le checkout hébergé ou un lien de paiement.

Pour vérifier un domaine pour le checkout inline, suivez ces étapes dans le dashboard :

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 checkout (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 fichier sur votre serveur à l’emplacement suivant :

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 indique Active, Apple Pay est disponible 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 checkout sur un appareil Apple.
Vérifiez que le bouton Apple Pay s’affiche.
Effectuez une transaction de test.

Configuration

Pour limiter une session de checkout à 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.

Exigences

Navigateurs : Chrome sur ordinateur et Android, ainsi que Firefox sur ordinateur. Le checkout n’affiche pas Google Pay dans Safari ni dans les navigateurs sur iOS. Dans 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 Allow sites to check if you have payment methods saved doit être activée.

Configuration

Pour limiter une session de checkout à 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 finaliser leur achat 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 checkout dépendent du processeur qui le prend en charge.
Abonnements : Non pris en charge.

Configuration

Pour limiter une session de checkout à 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 checkout à 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 checkout à 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 checkout, sans transfert d’argent réel.

Tests Apple Pay

Use Test Mode

Désactivez le bouton Live Mode dans la barre latérale du dashboard et utilisez des 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 checkout sur un appareil Apple et effectuez le flux Apple Pay.

Apple Pay nécessite HTTPS. Il ne s’affiche pas sur localhost, sauf si la page est servie via HTTPS.

Tests Google Pay

Join the Test Card Group

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

Enable Test Mode

Utilisez des 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 de test et suivez le flux de checkout 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 checkout.

SDK Web

Les portefeuilles numériques fonctionnent dans :

Le checkout en overlay, sauf Apple Pay.
Le checkout inline. Apple Pay nécessite une vérification du domaine.
Une intégration API directe avec le checkout hébergé.

SDK mobiles (Checkout)

Les SDK de checkout Android, iOS, React Native et Flutter ouvrent le checkout hébergé de 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 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 clients mobiles s’attendent à pouvoir utiliser Apple Pay et Google Pay. Affichez ces options de manière visible dans les checkouts mobiles.

Complete domain verification early

Si vous utilisez le checkout inline, 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 possèdent pas de 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 ne s’affiche pas sur un appareil non pris en charge ou lorsque le client n’a aucune carte enregistrée. Gardez les autres moyens de paiement visibles pour ces clients.

Dépannage

Apple Pay button not appearing

Vérifiez :

Pour le checkout inline, 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 checkout est-il en overlay ? Apple Pay n’est pas disponible dans le checkout en overlay.

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 en Pending possède généralement un fichier que Dodo Payments ne parvient pas à récupérer comme prévu.Vérifiez :

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 entraîne l’échec de 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 barrières d’authentification et les règles de pare-feu permettent souvent à la requête d’aboutir pour vous, mais pas pour Dodo Payments.Solution : Corrigez le problème d’hébergement, puis cliquez à nouveau sur Verify domain. Si le domaine ne devient pas Active après une vérification réussie, contactez support@dodopayments.com en indiquant le nom du domaine.

Google Pay button not appearing

Vérifiez :

Le client utilise-t-il un navigateur pris en charge ? Google Pay ne s’affiche pas dans Safari ni dans les navigateurs sur iOS.
Le client possède-t-il des cartes dans Google Pay ?
Le paramètre Chrome Allow sites to check if you have payment methods saved est-il activé ?
google_pay est-il 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 est expirée ou invalide.
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 s’affichent 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 checkout en overlay sur votre page.

Testing Process

Données de test pour chaque moyen de paiement.

Mobile Integration Guide

Ouvrez le checkout 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

Apple Pay en Inde

Vérification du domaine

Configuration

Google Pay

Exigences

Configuration

Amazon Pay

Disponibilité

Configuration

Cash App Pay

Disponibilité

Configuration

RevolutPay

Disponibilité

Configuration

Tests

Tests Apple Pay

Tests 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

​Apple Pay en Inde

​Vérification du domaine

​Configuration

​Google Pay

​Exigences

​Configuration

​Amazon Pay

​Disponibilité

​Configuration

​Cash App Pay

​Disponibilité

​Configuration

​RevolutPay

​Disponibilité

​Configuration

​Tests

​Tests Apple Pay

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

Apple Pay en Inde

Vérification du domaine

Configuration

Google Pay

Exigences

Configuration

Amazon Pay

Disponibilité

Configuration

Cash App Pay

Disponibilité

Configuration

RevolutPay

Disponibilité

Configuration

Tests

Tests Apple Pay

Tests 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