Collapse the table of content
Expand the table of content

Microsoft.Phone.Wallet Namespace

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

The Microsoft.Phone.Wallet namespace provides types for interacting with the Wallet feature of the phone. Apps can add and manage items in the Wallet, define payment instruments and interact with NFC and the Secure Element on the phone.


If you use this API in your app, you must specify the following capabilities in the app manifest. Otherwise, your app might not work correctly or it might exit unexpectedly.


API that requires this capability


Required for all Wallet API, which is anything in Microsoft.Phone.Wallet or Microsoft.Phone.SecureElement.


Required for PaymentInstrument and OnlinePaymentInstrument.


Required for SecureElementSession, SecureElementChannel and SecureElementReader.

For more info, see App capabilities and hardware requirements for Windows Phone 8.

Public classCustomWalletPropertyDefines a custom property on a wallet item. Using CustomWalletProperty, apps can attach app-specific data to a wallet item.
Public classDealA deal wallet item.
Public classOnlinePaymentInstrumentRepresents payment instruments imported from the Microsoft Billing System.
Public classOnlinePaymentInstrumentKindRepresents the kinds of online payment instruments that are supported.
Public classPaymentInstrumentA wallet item that represents a payment instrument.
Public classRefreshDataEventArgsRepresents arguments used in wallet item update event.
Public classWalletProvides an app access to its Wallet items.
Public classWalletAddressRepresents a wallet item’s address.
Public classWalletAddressesRepresents a group of addresses associated with a wallet item.
Public classWalletAgentAn implementation of a BackgroundAgent specifically designed to enable a wallet app to be notified about wallet operations related to wallet items specific to that app.
Public classWalletItem Base class for all wallet items. All items that can be stored in the wallet are derived from this class.
Public classWalletItemCollectionRepresents a read-only collection of wallet items.
Public classWalletPhoneNumbersRepresents a group of phone numbers related to a wallet item.
Public classWalletPropertyBaseProvides properties that are inherited by derived classes including WalletTransaction.
Public classWalletTransactionRepresents a single wallet transaction in the transaction history.
Public classWalletTransactionItemRepresents a generic wallet item that supports a transaction history and can have an applet in the secure element on the phone.
Public classWalletTransactionItemBaseThe base class for transactional wallet items.

Public interfaceIWalletTransactionHistoryExposes wallet item transaction history.

Public enumerationPaymentInstrumentKindsSpecifies the kinds of payment instruments that are supported.
Public enumerationWalletItemUsagesDefines what the wallet item can be used for. These are flags; bitwise operations can be used to combine them.
Public enumerationWalletUserActionResultKindRepresents the kinds of result that are possible from a user action on a wallet item.

© 2017 Microsoft