Wallet payment support

This article provides an overview of wallet payment support for Microsoft Dynamics 365 Commerce.

Key terms

Term	Description
Wallet	A payment type that doesn't include traditional payment characteristics, such as the Bank Identification Number (BIN) range and expiration date, that are used to differentiate credit and debit card types.
Processor payment method	A property payment card property in the payments SDK. When this property is added to supported payment methods within a connector, those payment methods can be mapped to cards or wallets configured in Commerce headquarters to avoid the traditional BIN range mapping.
Payment service provider (PSP) reference	The key that Adyen uses to identify payment transactions. This feature enables the PSP reference to be shown on the retail store transactions and call center authorization details pages.

Unlike traditional credit and debit cards, wallet payment authorization responses don't include BIN ranges. Traditionally, BIN ranges have been used to match payment authorization responses to predefined card types that have BIN ranges. The wallet payment support feature adds support for processor payment methods and mapping of those variants to card types that are set up in Commerce headquarters.

Processor payment method is a property for the payments SDK that can be applied to payment methods supported for a particular payment connector. When an authorization response is received that includes the processor payment method, a lookup is performed to determine if that processor payment method has been mapped to a card or wallet type. If a mapping is found, that payment is mapped to the matching card or wallet type. If a match can't be found, a BIN lookup is performed following the traditional BIN range settings for Commerce.

Because wallet payments don't include BIN range, if a payment connector such as PayPal supports wallet payments, the payment connector should be updated to the latest payments SDK and the processor payment method property should be populated at least for all supported wallet payments.

Processor payment method mappings are also useful for traditional debit and credit card payments. Mapping processor payment methods to cards is more straightforward than BIN range mapping and less prone to errors because it is easy to ensure all possible payment methods supported by a connector are mapped to a card or wallet type.

Enable wallet payment support

To enable wallet payment support in Commerce headquarters, go to Workspaces > Feature management, and then search for the Enhanced wallet support and payment improvements feature. Select the feature, and then select Enable. After you enable the feature, run the 1110 distribution schedule to make it available in all channels.

Other payment enhancements that are enabled by the wallet payment support feature

In addition to enabling wallet payment support, the wallet payment support feature enhances the payment details that are available in Commerce headquarters for payments that are created by using the Dynamics 365 Payment Connector for Adyen.

In the call center, the wallet payment support feature adds two fields to the default view for payment authorization details. First, the existing Processor reference column is filled with the PSP reference that is provided by Adyen. The PSP reference is the key that Adyen uses to look up payments. Second, the existing Approval code column is filled with the approval code value that is provided in the authorization from Adyen.

For retail store transactions, additional enhancements have been added to the payment transactions view for payments that are created using the Adyen connector. The Approval code field shows the approval code from the processor, the Processor payment field shows the processor payment method, and the Processor reference field shows the PSP reference from Adyen. These three fields aren't discrete fields in the database, and are only shown in the user interface when a specific payment is viewed. A payment processed using the Dynamics 365 Payment Connector for PayPal also provides the Approval code, Processor payment and Processor reference field values. Before the fields can be shown, the point of sale (POS) client must be updated with Commerce version 10.0.20 or later, and the Enabled status for the Enhanced wallet support and payment improvements feature must be synchronized to the channel.

Note

The Dynamics 365 Payment Connector for PayPal does not provide the three field values (Approval code, Processor payment, Processor reference) for payment void requests due to a limitation of the PayPal API. The three fields will be blank in the user interface.

Wallet payment method support and processor payment methods

This feature supports a new payment method and card type called Wallet. The primary characteristic of a wallet payment is that it does not have a BIN range. However, wallet payment methods may not return expiration dates and some properties that have traditionally been considered mandatory. Wallet payment methods must be mapped to processor payment methods as an alternative to the traditional BIN range mapping.

Adding support of processor payment methods

To support processor payment methods, payment connectors need to populate the PaymentMethodVariant property in PaymentCardProperties. If the payments SDK in use does not include this property, it should be updated.

Processor payment method mapping

The Processor payment method mapping page can be used to map processor payment methods to configured card or wallet types. To access this page, select the Processor mapping link on the Card types page.

When this page opens, it queries available payment connectors to collect a set or payment methods with the PaymentMethodVariant field populated. It then checks to determine if those payment methods have an existing mapping to a card or wallet. Payment methods that do not have a mapping are listed in the center column of the page.

To map a processor payment method to a card or wallet, select the card or wallet, select the processor payment method, and then select Add. The processor payment method moves to the Mapped column. When a matching payment authorization is received, it will be mapped to the chosen card or wallet.

Note

The Processor payment method mapping capability adds a new table that must be synchronized to the channel database. To add this data to the Commerce scheduler, you need to initialize the Commerce scheduler. For details, please refer to documentation related to updating commerce scheduler configurations.

When not to use processor payment method mapping

In certain cases, processor payment method mapping may not be granular enough for reporting needs. For example, some retailers differentiate external gift cards from the same provider by their BIN range. In this scenario, the gift cards should not be mapped using the above scenario. Instead, they should continue to use traditional BIN range mapping.

Support for unidentified card types

In some scenarios, a payment connector may return a card that does not have a BIN range or processor payment method mapping. If this occurs, the payment is authorized by the payment terminal, but is then reversed when the point of sale (POS) can't map the authorization response to a specific card type. To address this, a capability is provided to map unknown authorization responses to a default card type.

This capability ensures that the payment is never authorized by the terminal and then reversed by the POS. This helps avoid confusion for customers and store associates. When this setting is used, the default card for unknown authorizations should be checked periodically to ensure that wanted card types are not accidentally being mapped to the default for unknown card types. If a card type is truly unwanted for processing, it should be turned off at the processor level.

Additional resources

• Payments FAQ
• Dynamics 365 Payment Connector for PayPal
• Dynamics 365 Payment Connector for Adyen