Digital Wallets

Digital wallets let customers pay with a card or account already saved on their device, without typing card details. The wallet sends a token instead of the card number, and the customer confirms the payment with a tap or biometric check.

Supported Wallets

Dodo Payments shows each wallet only when the checkout matches its country, currency, and payment type:

Wallet	Availability	Currencies	Subscriptions	Setup Required
Apple Pay	Global, including India	All, including INR	Yes	Domain verification for inline checkout
Google Pay	Global (except India)	All	Yes	None
Amazon Pay	Global (except India)	USD, EUR, GBP, AUD, CHF, DKK, HKD, JPY, NOK, NZD, SEK, ZAR	No	None
Cash App Pay	US only	USD	Yes	None
RevolutPay	Global	GBP	No	None

PayPal is temporarily unavailable for new transactions.

Apple Pay

Apple Pay lets customers pay with cards saved in Apple Wallet and confirm with Face ID or Touch ID.

Apple Pay appears for subscriptions even when the first charge is $0, such as a free trial, so the payment mandate is set up at signup. For one-time payments, Apple Pay appears only when the amount is greater than $0.

Requirements

Devices: iOS 17 or later, iPadOS 17 or later, or Safari 17 or later on macOS. In India, Apple requires iPhone XR or later on iOS 18 or later.
Protocol: The page must load over HTTPS.
Domain: For inline checkout, the domain must be verified with Apple.

Apple Pay in India

Customers in India can pay with Apple Pay on checkouts billed in INR. Apple Pay in India works under these conditions:

Currency: The checkout is billed in INR. A payment billed in INR must be at least ₹5.
Cards: The customer has a card in Apple Wallet from an Indian bank that supports Apple Pay. Apple controls which banks and cards are eligible.
Desktop: In a desktop browser, customers can scan a code with their iPhone and confirm the payment on the phone.
Subscriptions: Apple Pay subscriptions in INR run on RBI mandates. Each renewal charge completes about 48 hours after the renewal date, as with other Indian-issued cards.

To bill a customer in India in INR, follow the India Payment Methods requirements for billing country and Adaptive Currency.

Domain Verification

Domain verification is required only for inline (embedded) checkout. Hosted checkout and payment links show Apple Pay without it.

Apple Pay is not available in overlay checkout. To offer Apple Pay, use inline checkout, hosted checkout, or a payment link.

To verify a domain for inline checkout, follow these steps in the dashboard:

Open Apple Pay Domains

Go to Settings → Payment Methods. On the Apple Pay row, click Manage domains.

Manage domains button on the Apple Pay row in Payment Methods settings — Open Apple Pay domains from the Apple Pay row

Download the Domain Association File

In the Apple Pay domains panel, click Download file.

Apple Pay domains panel with the Download file button — Download the Apple Pay domain association file

Click Register domain, enter the domain where you embed checkout (for example, shop.example.com), and click Continue.

Register a domain form with a domain entered — Register the domain where you embed checkout

Host the File on Your Domain

Upload the file to your server at this path:

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

Serve the file over HTTPS, without redirects, with Content-Type: application/octet-stream or text/plain.

Verify the Domain

Click Verify domain. Dodo Payments checks the hosted file and submits your domain to Apple.

Verify your domain screen with the association file host path and Verify domain button — Verify the hosted association file

Confirm It's Active

When the status shows Active, Apple Pay is live on that domain. To turn Apple Pay on or off for one domain, use its Enabled toggle.

Apple Pay domains list showing domains with an Active status and Enabled toggles — Verified domains show an Active status

Test the Integration

Open checkout on an Apple device.
Confirm that the Apple Pay button appears.
Complete a test transaction.

Configuration

To limit a checkout session to Apple Pay and cards, pass 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 lets customers pay with cards saved in their Google account.

Requirements

Browsers: Chrome on desktop and Android, and Firefox on desktop. Checkout doesn’t show Google Pay in Safari or in any browser on iOS. On those browsers, customers can pay with Apple Pay or a card.
Devices: Android devices with the Google Pay app.
Settings: In Chrome, Allow sites to check if you have payment methods saved must be on.

Configuration

To limit a checkout session to Google Pay and cards, pass 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 needs no domain verification.

Amazon Pay

Amazon Pay lets customers check out with the payment methods saved in their Amazon account.

Availability

Region: Global, except India.
Currencies: USD, EUR, GBP, AUD, CHF, DKK, HKD, JPY, NOK, NZD, SEK, ZAR. Which currencies a checkout offers depends on the processor that serves it.
Subscriptions: Not supported.

Configuration

To limit a checkout session to Amazon Pay and cards, pass 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 lets US customers pay from their Cash App account.

Availability

Region: US only. The billing country must be the US.
Currency: USD only.
Subscriptions: Supported.

Configuration

To limit a checkout session to Cash App Pay and cards, pass 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 lets Revolut users pay from their Revolut account balance or linked cards.

Availability

Region: Global.
Currency: GBP only.
Subscriptions: Not supported.

Configuration

To limit a checkout session to RevolutPay and cards, pass 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'
});

Testing

In test mode, wallet payments run through the same checkout flow without moving real money.

Apple Pay Testing

Use Test Mode

Turn off the Live Mode switch in the dashboard sidebar, and use API keys created in test mode.

Add a Card to Apple Wallet

Add a real card to Apple Wallet. In test mode, the card isn’t charged.

Complete a Test Purchase

Open checkout on an Apple device and complete the Apple Pay flow.

Apple Pay requires HTTPS. It doesn’t appear on localhost unless the page is served over HTTPS.

Google Pay Testing

Join the Test Card Group

Join the Google Pay test card group to have test cards added to your wallet.

Enable Test Mode

Use API keys created in test mode.

Complete a Test Purchase

Select one of the test cards in Google Pay to complete the transaction.

Amazon Pay & Cash App Pay

Use your test mode API keys and follow the standard checkout flow. Test transactions are simulated, and no real charge occurs.

SDK Support

Wallet availability depends on how you present checkout.

Web SDKs

Digital wallets work in:

Overlay Checkout, except Apple Pay.
Inline Checkout. Apple Pay requires domain verification.
Direct API integration with hosted checkout.

Mobile SDKs (Checkout)

The Android, iOS, React Native, and Flutter checkout SDKs open Dodo Payments hosted checkout in the platform’s system browser (SFSafariViewController on iOS, Chrome Custom Tabs on Android), not in a WebView. Apple Pay and Google Pay work there the same way they do on the web. See the Mobile Integration Guide for setup.

Best Practices

Prioritize wallets on mobile

Mobile customers expect Apple Pay and Google Pay. Show these options prominently on mobile checkouts.

Complete domain verification early

If you use inline checkout, verify your domain for Apple Pay during development, not on launch day.

Always include card fallbacks

Not every customer has a digital wallet. Include credit and debit in allowed_payment_method_types.

Test on real devices

Simulators don’t fully replicate wallet behavior. Test on real iOS and Android devices before launch.

Handle wallet unavailability

A wallet doesn’t appear on an unsupported device or when the customer has no saved cards. Keep other payment methods visible for these customers.

Troubleshooting

Apple Pay button not appearing

Check:

For inline checkout, is the domain verified in Manage domains?
Does the page load over HTTPS?
Is the device on iOS 17, iPadOS 17, or Safari 17 or later?
Does the customer have cards in Apple Wallet?
Is apple_pay included in allowed_payment_method_types?
Is the checkout an overlay? Apple Pay isn’t available in overlay checkout.

Solution: Complete domain verification and serve the page over HTTPS. Test on a real Apple device.

Apple Pay domain stuck on Pending

After you click Verify domain, Dodo Payments fetches the association file from your domain and submits the domain to Apple. A domain that stays on Pending usually has a file that Dodo Payments can’t fetch as expected.Check:

The file is reachable at https://<your-domain>/.well-known/apple-developer-merchantid-domain-association.
It is served over HTTPS with a valid certificate.
It resolves without redirects. A redirect to www, to another host, or to an error page fails the check.
It is served as Content-Type: application/octet-stream or text/plain, not text/html.
It is the file downloaded from Manage domains for this business, not one reused from another account or provider.

To confirm the file is publicly reachable, request the URL from outside your own network, such as in a private browsing window. Staging passwords, authentication walls, and firewall rules often let the request succeed for you but fail for Dodo Payments.Solution: Fix the hosting issue, then click Verify domain again. If the domain doesn’t become Active after a successful check, contact support@dodopayments.com with the domain name.

Google Pay button not appearing

Check:

Is the customer using a supported browser? Google Pay doesn’t appear in Safari or in any browser on iOS.
Does the customer have cards in Google Pay?
Is the Chrome setting Allow sites to check if you have payment methods saved on?
Is google_pay included in allowed_payment_method_types?

Solution: Check the browser and the customer’s Google Pay setup.

Wallet payment failed

Common causes:

The card in the wallet is expired or invalid.
The bank declined the transaction.
A network connection problem interrupted the payment.

Solution: Ask the customer to check the card in their wallet or to use a different payment method.

Wrong device type

Digital wallets appear only on compatible devices:

Apple Pay: Apple devices only.
Google Pay: Chrome or Android devices.

Solution: This is expected. Keep card payments available as a fallback.

Payment Methods Overview

All supported payment methods.

Overlay Checkout

Open checkout as an overlay on your page.

Testing Process

Test data for every payment method.

Mobile Integration Guide

Open hosted checkout in the system browser, where Apple Pay and Google Pay work as on the web.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Supported Wallets

Apple Pay

Requirements

Apple Pay in India

Domain Verification

Configuration

Google Pay

Requirements

Configuration

Amazon Pay

Availability

Configuration

Cash App Pay

Availability

Configuration

RevolutPay

Availability

Configuration

Testing

Apple Pay Testing

Google Pay Testing

Amazon Pay & Cash App Pay

SDK Support

Web SDKs

Mobile SDKs (Checkout)

Best Practices

Troubleshooting

Payment Methods Overview

Overlay Checkout

Testing Process

Mobile Integration Guide

​Supported Wallets

​Apple Pay

​Requirements

​Apple Pay in India

​Domain Verification

​Configuration

​Google Pay

​Requirements

​Configuration

​Amazon Pay

​Availability

​Configuration

​Cash App Pay

​Availability

​Configuration

​RevolutPay

​Availability

​Configuration

​Testing

​Apple Pay Testing

​Google Pay Testing

​Amazon Pay & Cash App Pay

​SDK Support

​Web SDKs

​Mobile SDKs (Checkout)

​Best Practices

​Troubleshooting

​Related Pages

Payment Methods Overview

Overlay Checkout

Testing Process

Mobile Integration Guide

Supported Wallets

Apple Pay

Requirements

Apple Pay in India

Domain Verification

Configuration

Google Pay

Requirements

Configuration

Amazon Pay

Availability

Configuration

Cash App Pay

Availability

Configuration

RevolutPay

Availability

Configuration

Testing

Apple Pay Testing

Google Pay Testing

Amazon Pay & Cash App Pay

SDK Support

Web SDKs

Mobile SDKs (Checkout)

Best Practices

Troubleshooting

Related Pages