The Mangopay API allows you to customize the text that appears on the bank statement of an end user.
You can do this by sending custom text in specific parameters of the API (depending on the transaction and payment method). This is entirely optional, but it can help your end users to identify a transaction made on your platform.
The string of text that appears on the bank statement to describe a transaction contains, in order:
Because the 3 elements appear on one line of the bank statement, space is very limited and the custom text may be truncated.
It is possible for your platform to change its trading name to make it shorter, but this is controlled by Mangopay’s teams as part of its verification obligations.
Note – Banks have ultimate control of the text displayed
Mangopay can supply a string of text for the bank statement but ultimately it is the user’s bank that decides if and how much of that information is displayed.
On pay-ins, platforms can use the StatementDescriptor
parameter to send custom text (only alphanumeric characters or spaces).
The structure of the complete string sent is:
MGP*
TradingName
StatementDescriptor
On the following endpoints, the StatementDescriptor
length is limited to 10 characters:
For direct debits (on the Create a Direct Debit PayIn) the StatementDescriptor
constraints differ depending on the Mandate scheme:
For SEPA Direct Debit pay-ins, the structure of the string sent is different:
StatementDescriptor
TradingName
For refunds, the StatementDescriptor
is only available on the direct debit payment method, both SEPA and BACS.
The length is limited to 10 characters (alphanumeric or spaces).
The string sent is only the parameter:
StatementDescriptor
On payouts, platforms can use the BankWireRef
parameter to send custom text, including special characters.
The structure of the complete string sent is:
MGP*
TradingName
BankWireRef
On payouts, the recommended length is 12 characters. Strings longer than this may be truncated depending on the bank. The technical limit is 255 characters.
The Mangopay API allows you to customize the text that appears on the bank statement of an end user.
You can do this by sending custom text in specific parameters of the API (depending on the transaction and payment method). This is entirely optional, but it can help your end users to identify a transaction made on your platform.
The string of text that appears on the bank statement to describe a transaction contains, in order:
Because the 3 elements appear on one line of the bank statement, space is very limited and the custom text may be truncated.
It is possible for your platform to change its trading name to make it shorter, but this is controlled by Mangopay’s teams as part of its verification obligations.
Note – Banks have ultimate control of the text displayed
Mangopay can supply a string of text for the bank statement but ultimately it is the user’s bank that decides if and how much of that information is displayed.
On pay-ins, platforms can use the StatementDescriptor
parameter to send custom text (only alphanumeric characters or spaces).
The structure of the complete string sent is:
MGP*
TradingName
StatementDescriptor
On the following endpoints, the StatementDescriptor
length is limited to 10 characters:
For direct debits (on the Create a Direct Debit PayIn) the StatementDescriptor
constraints differ depending on the Mandate scheme:
For SEPA Direct Debit pay-ins, the structure of the string sent is different:
StatementDescriptor
TradingName
For refunds, the StatementDescriptor
is only available on the direct debit payment method, both SEPA and BACS.
The length is limited to 10 characters (alphanumeric or spaces).
The string sent is only the parameter:
StatementDescriptor
On payouts, platforms can use the BankWireRef
parameter to send custom text, including special characters.
The structure of the complete string sent is:
MGP*
TradingName
BankWireRef
On payouts, the recommended length is 12 characters. Strings longer than this may be truncated depending on the bank. The technical limit is 255 characters.