Digital wallet fundamentals

How do digital wallets work for merchants?

For a merchant, a digital wallet is another way for a customer to present payment credentials at checkout. The customer chooses a card or other eligible payment method saved with the wallet, confirms the purchase, and the wallet supplies payment data to the merchant's acceptance system. The merchant's processor or payment service provider then routes the transaction for authorization. The exact setup varies by wallet, sales channel, provider, device, and merchant configuration.

The merchant-side flow at a glance

  1. The customer selects a wallet. At a physical checkout, this may involve presenting a supported consumer device to an enabled acceptance device. On a website or app, the customer chooses a wallet button or payment option.
  2. The customer confirms the purchase. The wallet presents the available payment methods and asks the customer to complete the wallet's required confirmation step.
  3. The wallet returns payment data. Depending on the implementation, this can include an encrypted payment object or payment token rather than the underlying primary account number.
  4. The merchant system submits the transaction. The point-of-sale system, website backend, gateway, or payment service provider passes the required transaction information into the payment-processing flow.
  5. The issuer returns a decision. The request travels through the applicable payment participants for authorization. The merchant receives the resulting approval or decline through its normal acceptance interface.

This sequence describes the general pattern, not a promise that every wallet behaves identically. Refunds, recurring payments, delayed capture, tips, loyalty, receipts, and reporting can differ by provider and configuration.

What the wallet changes—and what it does not

Customer credential selection

The wallet gives the customer an interface for choosing an eligible stored payment method. The merchant does not decide which cards appear inside a customer's wallet, and the presence of a card does not guarantee that a particular transaction will be authorized.

Payment-data presentation

Many wallet flows use payment tokenization. EMVCo describes an EMV payment token as an alternative value that replaces a primary account number and can be limited to a merchant, device, or payment scenario. The form of data delivered to the merchant depends on the implementation.

Existing processing roles

A wallet normally does not replace the merchant's acceptance and processing stack. Official Google Pay documentation, for example, describes the website sending a returned payment token to its backend and then to a payment service provider. Apple similarly documents a payment token moving to the merchant or its provider for processing.

Authorization outcome

The wallet does not guarantee approval. The issuer still receives a payment request and may approve or decline it. Merchants should keep ordinary decline handling, order confirmation, reconciliation, and customer-service procedures in place.

In-person and online acceptance use different paths

At a physical checkout

The customer typically presents a wallet-enabled consumer device to a merchant acceptance device using a supported proximity method. The checkout system receives payment data and continues through the configured card-payment flow. A contactless symbol or a wallet name on a device is not enough to prove that a merchant's full configuration is ready. The terminal model, payment application, processor setup, network connection, and enabled payment methods all need to be confirmed through the responsible provider.

On a website or app

The merchant presents a wallet option through its ecommerce platform, application, gateway, or payment provider. The customer selects a payment method in the wallet interface, and the merchant's frontend passes the resulting payment object to a secure backend or provider-controlled integration. Google states that its web API returns a payment token to the site, which sends it with purchase details to the backend and payment service provider. Apple documents an encrypted payment token that the merchant or its provider processes after customer confirmation.

For broader context, review the Ecommerce & Online Payments FAQ hub and the Mobile Payments & Contactless FAQ hub.

Questions to resolve before enabling a wallet

  • Sales channel: Decide whether the need is at the counter, on a website, inside an app, or across several channels.
  • Provider path: Ask the current processor, gateway, ecommerce platform, or payment service provider which wallet options it supports for the merchant's exact account and workflow.
  • Implementation ownership: Identify who will configure the terminal, install the approved integration, register domains, manage certificates, or request production access when those steps apply.
  • Transaction lifecycle: Confirm how authorization, capture, voids, refunds, recurring use, tips, partial amounts, and order changes work for the selected setup.
  • Operations: Verify how wallet transactions appear on receipts, dashboards, settlement reports, exports, and customer-service tools.
  • Testing: Use the provider's documented test and launch process. Test successful and declined transactions, cancellations, duplicate-click protection, order confirmation, and reconciliation before relying on the option.

Do not infer support from a generic device feature list or another merchant's setup. Provider and platform documentation changes, and a wallet may be available through one channel but not another. The safest next step is to verify the exact combination of merchant account, acceptance device or checkout platform, gateway, processor, and transaction types.

Keep customer data and support requests separate

A wallet can reduce the need for a merchant interface to handle an underlying card number directly, but it does not remove the merchant's responsibility to operate its checkout and connected systems carefully. Use approved integrations, restrict administrative access, maintain accurate order records, and follow the payment provider's instructions for handling transaction identifiers and customer-service cases.

Never paste payment tokens, complete card numbers, cryptograms, passwords, bank credentials, secret API keys, or production certificates into a general contact form, email, or support note. When troubleshooting, begin with non-sensitive details such as the sales channel, device or platform name, timestamp, displayed error, order reference, and the provider's non-secret transaction reference.

Explore the Digital Wallets & Alternative Payments hub, read about payment workflows for online and digital businesses, or visit the Payments FAQ library for related planning questions.

Frequently asked merchant questions

Does a digital wallet replace a merchant account or processor?

Generally, no. The wallet presents payment data, while the merchant's configured acceptance and processing services route the transaction. The exact parties and responsibilities depend on the selected provider and implementation.

Does the merchant receive the customer's actual card number?

Not necessarily. Many wallet implementations return a tokenized or encrypted payment object. Merchants should rely on the provider's documentation for the exact data their integration receives and should not attempt to recover or store sensitive credentials.

Will every digital wallet work with every checkout?

No universal compatibility should be assumed. Availability depends on the wallet, country or region, customer device, card issuer, merchant provider, sales channel, hardware, software, and enabled configuration.

Map the wallet to the actual checkout workflow

Start with the channel where customers pay, the current payment provider, and the transaction types the business needs. Payments Max can help organize evaluation questions, but the responsible processor, gateway, platform, or payment service provider must confirm current support and implementation requirements for a specific setup.

Discuss digital payment requirements

To learn more about how TSYS can help improve the way your organization accepts payments, markets to new customers, or manages its HR responsibilities, get in touch by calling 585-981-8463 to get started.

CONTACT US