Σημείωση
Η πρόσβαση σε αυτή τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να συνδεθείτε ή να αλλάξετε καταλόγους.
Η πρόσβαση σε αυτή τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να αλλάξετε καταλόγους.
Note
The Retail Interest Group by Dynamics 365 Commerce has moved from Yammer to Viva Engage. If you don't have access to the new Viva Engage community, fill out this form (https://aka.ms/JoinD365commerceVivaEngageCommunity) to be added and stay engaged in the latest discussions.
This article describes how the payments software development kit (SDK) for Microsoft Dynamics 365 Commerce supports tip amounts that customers enter through a payment terminal. The purpose of this feature is to add first-class support to the payments SDK by including a separate field for the tip amount in authorization responses.
This feature doesn't add support for tipping or tip reporting at the point of sale (POS). Implementation of full tipping capabilities requires POS extensions.
Key terms
| Term | Description |
|---|---|
| Tips | Tips, which are also known as gratuities, are common in the quick service and hospitality industries. They enable a payment to be given directly to the store or restaurant employee who provides services. |
| Header-level charge | A charge that you can apply to a purchase, but that isn't for a specific line item. |
Summary of the tipping feature
Tipping is common in some locales and industries. For example, in the quick service and hospitality industries, tipping is now done almost everywhere in the United States. For many businesses, the ability to support tipping through payment terminals is becoming an important factor that helps attract employees. This feature adds a separate TipAmount field to the payments SDK, so that tip amounts that customers select on the payment terminal can be sent back to the POS as part of the authorization response.
Although this feature adds support for tipping at the level of the payments SDK, it doesn't include support for other important aspects of tipping functionality. For example, the feature doesn't support reporting of tip payouts at the end of shifts, the ability to pool tips, or the ability to report tips for payroll. To enable full tipping support, you must implement those capabilities through extensions.
For more information about how to create the payment terminal integrations and SDK references that are mentioned in this article, see Create an end-to-end payment integration for a payment terminal.
Prerequisites
| Prerequisite | Description |
|---|---|
| Tip support on devices | Customers must be able to select a tip amount on the payment terminal. |
| isTippingEnabled support | Payment connectors must support the isTippingEnabled variable for payment initialization. |
| TipAmount field | The tip amount must be returned from the payment connector in the TipAmount field of the authorization response. |
| POS tip support through extension | The tip amount that the payment connector returns should be added to the sale as a header-level charge. Tip reporting and management aren't provided out of the box. |
Tipping support by payment processors
This feature adds a new isTippingEnabled variable to the AuthorizePaymentTerminalDeviceRequest request. When a payment is requested from the POS, this variable indicates whether the authorization request is eligible to have a tip added. Payment connectors that receive this request can then request a tip-eligible authorization from the connected payment service or terminal.
When the isTippingEnabled variable is set to True, if a customer selects a tip amount on the payment terminal, the payment connector returns that amount in the TipAmount field of the AuthorizePaymentCardPaymentResponse response. The tip amount is also included in the ApprovedAmount field of the authorization response.
Tipping support for the Adyen connector
The Adyen connector includes tip support. Customization is required to set the isTippingEnabled variable to True when the authorization response is passed to the connector. When the isTippingEnabled variable is set to True, if a customer selects a tip amount on the device, the payment connector returns that amount in the TipAmount field of the authorization response.
Before a customer can be prompted to select a tip amount on the Adyen terminal, the terminal must be configured for tipping. Configure this setting through the Adyen customer area. To enable tipping, select the Point of Sale tab in the Adyen portal. You can enable tipping by terminal or through the fleet-wide Terminal settings option. In both the settings for individual terminals and the fleet-wide terminal settings, enable tipping on the Payment features tab. After enabling tipping on your Adyen device, update the settings on the device. The change doesn't take effect until this update is done.
Suggested implementation
Use a header-level charge to add the tip amount to the transaction after the authorization response returns from the payment connector. To support this functionality, create an extension for the PaymentTerminalAuthorizePaymentRequestHandler handler. Include logic in that extension to add a header-level charge to the transaction if a TipAmount value is returned in the authorization response.
Additional resources
Create an end-to-end payment integration for a payment terminal