Wallets Fresh

Wallets let customers pay online or in person using saved credentials (tokenized cards/bank accounts) or stored balances.

How wallets work

At checkout, the wallet authenticates the customer and passes payment details or a token. You don't handle the customer's raw card data.

Web flow: Customer selects wallet → Authenticates via mobile (scan QR code or tap) → Payment completes
Mobile flow: Customer selects wallet → Authenticates with biometric or PIN → Payment completes

Supported wallets

Wallet	Regions	Online	In-person
Apple Pay	US, EU, many more	Yes	Yes
Google Pay	Worldwide	Yes	Yes
PayPal	Worldwide	Yes	No
Link	US	Yes	No
Alipay	China, Asia	Yes	Limited
WeChat Pay	China, Asia	Yes	Limited
Revolut Pay	EU	Yes	No

Enable wallets

Enable wallets in Dashboard → Settings → Payment Methods. Most wallets are enabled with a single toggle — no additional contracts.

Stripe automatically displays eligible wallets to customers based on their device, browser, and region.

Apple Pay

Apple Pay works on:

• Safari on iOS, macOS
• In-app on iPhone and iPad

Apple Pay requires your domain to be registered with Stripe:

# Register domain via API
curl https://api.stripe.com/v1/apple_pay/domains \
  -u "sk_test_YOUR_KEY:" \
  -d domain_name=example.com

Or register in Dashboard → Settings → Payment Methods → Apple Pay → Add Domain.

Google Pay

Google Pay works on:

• Chrome browser on Android and desktop
• Android apps

No domain registration needed for web integrations.

Express Checkout Element

For a unified express checkout button (Apple Pay + Google Pay + PayPal in one):

const expressCheckoutElement = elements.create('expressCheckout');
expressCheckoutElement.mount('#express-checkout');

expressCheckoutElement.on('confirm', async (event) => {
  const { error } = await stripe.confirmPayment({
    elements,
    confirmParams: { return_url: 'https://example.com/success' },
  });
});

Wallet considerations

• Coverage varies — some wallets are tied to specific platforms or regions
• Subscription support — wallets often have limited or no recurring payment support. Verify before enabling for subscriptions.
• Refunds and disputes — timing and behavior may differ from card payments
• In-person vs online — some wallets are primarily in-person (NFC/QR), ensure you enable the right type

Recurring payments with wallets

Most wallets don't support merchant-initiated recurring charges. If subscriptions are core to your business, verify the wallet:

• Supports token/billing agreement creation for future charges
• Allows merchant-initiated recurring transactions
• Handles card updates and continuity
• Supports your retry and dunning behavior