Statement descriptors
Statement descriptors are the text that describe transactions presented to us by our digital banking feeds (or paper statements) so that we can recognize them. Setting clear statement descriptors can help to reduce disputes and improve the user experience by providing context on what the payment was for.
For card payments, Moov will use the statement descriptor added at the transfer or account level. Otherwise, Moov will default to the DBA or legal business name of the Moov account truncated based on payment network limits.
Account level statement descriptor
You can set the default statement descriptor for a merchant by using the account.settings.cardPayment.statementDescriptor
field in the PATCH
accounts endpoint. In the example provided, we set a statement descriptor for a local gym called “Whole Body Fitness” at the account level.
|
|
|
|
|
|
American Express statement descriptors
Before a transaction settles with the bank, American Express statements may show a description of Moov Financial
instead of the statementDescriptor
that has been set for the merchant. Once the transaction settles and moves beyond the pending
stage, the description will update with the statement descriptor that has been set for the merchant.
To avoid any confusion about the origin of the transaction, this information should be passed along to merchants to share with customers.
Transfer level statement descriptor
Optionally, source.cardDetails.dynamicDescriptor
in the CREATE
transfer endpoint allows a merchant to pass information to the card issuer at the time of transaction. The card issuer will then use this information to generate a description of the cardholder’s statement. In the example provided, we set a dynamic statement descriptor that captures the date of a yoga class at Whole Body Fitness.
|
|
|
|