getWalletsAvailable

1. Overview

The DEUNA SDKs provide the getWalletsAvailable method to obtain the list of digital wallet providers (Google Pay, Apple Pay) that are available and ready to process payments on the current device, browser, or mobile platform.

Make sure to follow the Getting Started guide for our SDKs depending on your specific integration:

• Web SDK >= v1.6
• Android SDK >= 2.11.0
• iOS SDK >= 2.11.0
• React Native SDK >= 2.1.0

Method signatures by platform:

type WalletProvidersEnum = "GOOGLE_PAY" | "APPLE_PAY";

What it does behind the scenes (by platform):

2. Use cases (all platforms)

3. Environment

• HTTPS — Both Apple Pay and Google Pay refuse to run on http:// (except localhost for development).
• Supported browser — evergreen Chrome, Edge, Firefox, Safari. Apple Pay only surfaces in Safari (in‑device) or iOS 18+ (QR fallback). Google Pay requires a signed‑in Google account with a saved card.
• Merchant configuration — the wallets you expect must be enabled for your merchant in the DEUNA Dashboard. A wallet that is disabled at the merchant level will never appear in the returned array.

3.1. Side effects to be aware of

• Caching: the first call initializes DeunaSDK.wallet and caches it. Subsequent calls return the cached list without re‑running SSR or capability checks. If you need to re‑check (e.g. after the user signs into Google), you must create a fresh SDK instance via DeunaSDK.newInstance().

• SSR state: when called via the SSR path, the SDK also stores resolvedWalletConfig, walletUserToken, and walletUserId internally — these are used by initElements for card tokenization.

4. Return value & handling empty results

The method returns an array containing only the providers that pass all platform-specific checks. An empty array [] means no wallet is available on the current device/platform.

Common reasons for empty results:

• Device/browser does not support any wallet (e.g., desktop Firefox without Google account)
• Merchant has no wallets enabled in DEUNA Dashboard
• Platform check failed (e.g., no saved card in Google account, Apple Wallet empty)
• SDK not initialized before calling getWalletsAvailable

Examples:

// Web / React Native
const available = await DeunaSDK.getWalletsAvailable();
if (available.length === 0) {
  showCardFormOnly();
  return;
}

// iOS
DeunaSDK.shared.getWalletsAvailable { providers, error in
    if let providers = providers, providers.contains(.applePay) {
        showApplePayButton()
    } else {
        showCardForm()
    }
}

// Android
DeunaSDK.getInstance().getWalletsAvailable { providers, error ->
    if (providers?.contains("GOOGLE_PAY") == true) {
        showGooglePayButton()
    } else {
        showCardForm()
    }
}

5. Platform-specific notes

6. Common mistakes (by platform)

7. When to use this method