Every Paytrail settlement includes a settlement reference generated by Paytrail. If you need a custom settlement reference format for your accounting or reconciliation processes, Paytrail can configure one for your account. Custom settlement references must follow the reference number formatting rules described below.
Custom settlement reference formats
By default, Paytrail uses the settlement number as the settlement reference. The settlement reference appears in your bank account statement and can be used to match incoming settlements with settlement reports in the Merchant Panel.
If you need a custom settlement reference format, contact our customer service team to set it up for your merchant account. Custom settlement reference formats must follow the formatting rules below to ensure valid reference numbers can be generated.
Custom reference formats are generated using a combination of fixed numbers and date placeholders. Only numbers and the placeholders below can be used in the reference format.
| Placeholder | Description | Example value |
|---|---|---|
| {dd} | Day | 01 |
| {mm} | Month | 01 |
| {yy} | Year with two digits | 16 |
| {yyyy} | Year with four digits | 2016 |
Example reference format:
12345{dd}{mm}{yyyy}678If the settlement date is 1 January 2016, the generated reference number would be:
1234501012016678
Reference number rules
Custom settlement reference formats must meet the following requirements:
Reference format contains placeholders
- Only numbers and the supported placeholders can be used.
- All placeholders are replaced with numeric values when the reference number is generated.
- After replacement, the reference number must be 3–19 digits long.
- Paytrail automatically calculates and adds a one-digit check digit.
Reference format contains only numbers
- The reference number must be 4–20 digits long.
- A check digit is not automatically calculated or added.