# Using dynamic merchant descriptor {#en_pp_descriptor}

An article about the capability of providing customers with information about merchants via issuer services.

## Overview {#section_u2p_3rk_mhc .section}

When Ecommpay acts as an acquirer, in compliance with the rules of card networksEcommpay shares merchant details with other parties involved in payment processing. These detailscan be used by each party at its discretion and can be specified in receipts and bank statements by issuers.

By default, merchant information isstatic and limited toagreed upon name of the merchant. However, the merchant can dynamically append additional detailsrelating to a particular paymentor other aspects of their business . These dynamic details can be included in the requests for opening Payment Pageand are only limited to the maximum string length and the permitted character set \(see [details](en_pp_descriptor.md#section_b3f_hvp_13c)\). For example, the merchant descriptor can include the merchant's name combined with a booking period \(`Cosmotour* 17-19 feb`\) or with the name of the reserved hotel \(`Cosmotour* MarsSuite`\).

![](images/ecommpay/en_gate_descriptor_2.svg "Adding booking period")

![](images/ecommpay/en_gate_descriptor_1.svg "Adding hotel name")

Flexible use of accurate and informative details makes it easier for customers to identify merchants and payments and allows merchants to improve user experience and reduce the risk of disputes.In the Ecommpay payment platform, dynamic descriptors are relevant for *card payments* \(including standard card payments and payments made with Apple Pay, Click to Pay, Google Pay, and Visa Instalments\) and such payment types as one-time and COF purchases, payouts, and payment instrument verification.

## Special aspects {#section_fhg_s3m_djc .section}

When working with merchant data, consider the following special aspects:

-   The primary purpose of the merchant descriptor is to help customers recognise payments they made and prevent unnecessary chargebacks.

    Hence, avoid ambiguous or potentially misleading information in the merchant descriptor. Focus on the information that enables the customer to identify both the merchant and each operation clearly. In particular, it is recommended that you use a familiar brand name together with a concise description of the goods or services related to the operation.

-   Requirements to the merchant descriptor can vary depending on the card network.

    Pay attention to such differences, at least regarding the supported formats \([details](en_pp_descriptor.md#section_b3f_hvp_13c)\).

-   The way merchant details are provided to users is determined by issuers.

    How merchant details will appear in receipts, bank statements, and other communication with the customer is determined by the rules of a specific issuer. As a result, merchant details may vary across issuers, different interfaces of the same issuer, and different operation types within a single interface. In particular, there may be differences due to processing different types of purchases ans payouts as well as Mastercard MoneySend and Visa Direct operations.


## Setup {#section_umd_gyr_djc .section}

The name of the merchant to be used as a default merchant descriptor is specified when the merchant is onboarded with the payment platform and, subsequently, can only be modified via the Ecommpay account manager.

To enable the use of the dynamic merchant descriptor, continue as follows:

1.  Coordinate with the Ecommpay account manager the roadmap of enabling the functionalityfor specific projects and the necessity for testing..
2.  If you need testing, get notified by the Ecommpay specialists that the capability is ready for being used in test mode,test this capability, and inform Ecommpay that everything is ready to launch.
3.  Get notified by the Ecommpay specialists that the capability has been added and fullyset up.

## Use {#section_okm_gyr_djc .section}

If you need to use the dynamic merchant descriptor, pass the corresponding parameter in the requests for opening Payment Page:

-   `merchant_descriptor` for purchases and payment instrument verification
-   `sender_descriptor` for payouts

Keep in mind that in cases when the values of the `merchant_descriptor` and `sender_descriptor` parameters do not conform to the required format \([details](en_pp_descriptor.md#section_b3f_hvp_13c)\), the platform can automatically correct them\(for example, by transliterating alphabetic characters and removing invalid non-alphabetic characters\). Such correction of values does not lead to declined payments. Also, note that the Ecommpay platform does not validatethe values of these parametersfor factual correctness, but this information can be analysed and subsequently used by the issuers. Merchants should therefore ensure that values provided in the `merchant_descriptor` and `sender_descriptor` parameters are both technically compliant and contextually accurate in every instance of use.

## Data format {#section_b3f_hvp_13c .section}

The maximum length of the merchant descriptor is determined by the card network. Mastercard sets a maximum length of 22 characters, while Visa sets a maximum length of 25 characters.Any characters exceeding these limits are truncated. Keep these limits and the allowed character requirements in mind when generating descriptions. The `merchant_descriptor` and `sender_descriptor` parameters can contain characters from the basic Latin alphabet, digits, a space character \(U+0020\) and the following symbols:

|`*`|U+002A|asterisk|
|`,`|U+002C|comma|
|`-`|U+002D|hyphen|
|`.`|U+002E|full stop|
|`=`|U+003D|equals sign|
|`_`|U+005F|underscore|

When generating the `merchant_descriptor` or the `sender_descriptor` parameter, use the agreed uponmerchant's name followed by additional details separated by an asterisk \(`*`\) and a space, ensuring compliance with the applicable string length restrictions. For example, if a 9-character name `Cosmotour` is used with a 2-character separator, the remaining string length available for additional details is 11 characters for Mastercard and 14 characters for Visa. This is enough for a value such as `Cosmotour* to the Moon`.

**Parent topic:**[Auxiliary procedures and additional capabilities](en_PP_Additional.md)