Shopping wallet apps

A shopping wallet is an application, such as an iOS wallet, that holds stablecoins or other supported assets. It helps its owner pay independent merchants.

The wallet can choose the payment rail that the merchant supports:

Merchant accepts stablecoin
  -> pay directly from the wallet

Merchant accepts cards only
  -> pay with an optional stablecoin-linked virtual card

The virtual card extends reach to existing ecommerce checkouts. It is an outbound spending credential for the wallet owner. A store gains little from issuing a card solely so a shopper can use it at that same store.

Product responsibilities

• show wallet funds, card reserve, pending holds, and available spend separately
• support direct stablecoin payment where the merchant accepts it
• allocate a bounded reserve before enabling card spending
• expose authorization, capture, reversal, refund, freeze, and close states
• disclose fees, exchange rates, provider limits, and reserve-release timing
• keep the card number (PAN) and security code (CVV) inside the provider's secure hosted UI
• reconcile wallet, issuer, and settlement evidence without duplicating value

Virtual-card issuance adds cardholder onboarding, fraud, chargebacks, liquidity, support, reconciliation, and regulatory responsibilities. It is optional. It suits qualified wallet operators whose users need to spend at external merchants.

Virtual-card issuance remains product direction. The published Wallet SDK exposes no card-issuance or card-lifecycle API. Use the SDK reference to identify the available wallet operations.