Payment reference normalization

Overview

The payment reference is an identifier used to identify a specific payment transaction. Monite payment links use one of the following as the payment reference:

• invoice document number (if the payment link was created for a payable or receivable invoice),
• payment_reference value (if the link was created for an external invoice or a one-off payment).

Most banks have rules for the format of payment reference. For example, the payment reference length is usually limited to 18 characters, and most special characters are forbidden.

When passing Open Banking payment details to the payment processing provider, Monite normalizes the payment reference value to make it compatible with common bank requirements. Keep this in mind when reconciling payments.

Normalization works as follows:

• Leading and trailing spaces are removed.
• Characters other than A-Z a-z 0-9 / - and spaces are replaced with spaces.
• If the resulting string is longer than 18 characters:
  • Consecutive spaces are replaced with a single space.
  • The string is trimmed to 18 characters.

Examples

Payment references that do not require normalization:

00123
PRJ123-INV-2024
BILL/2024/12/0045
Repair work 05/12
INV   12345

Examples of normalized payment references: