References & descriptions

There are some requirements that need to be met in order to ensure any references or descriptions are valid and to avoid any issues with processing.

Collect

The description field for a Collect request must satisfy the following requirements:

  • No more than 18 characters in length (only the first 9 will be visible to the payer)
  • May only include the following character set:
    • Letters: A-Z, a-z
    • Numbers: 0-9
  • May only include the following special characters:
    • spaces ( ) ,
    • ampersands (&),
    • apostrophes (‘),
    • commas (,) ,
    • hyphens (-),
    • full stops (.),
    • forward slashes (/),
    • plus sign (+),
    • dollar sign ($),
    • exclamation mark (!),
    • percentage sign (%),
    • left parenthesis ((),
    • right parenthesis ()),
    • asterisk (*),
    • number sign (#),
    • equal sign (=),
    • colon (:),
    • question mark (?),
    • left square bracket ([),
    • right square bracket (]),
    • underscore (_),
    • circumflex (^), and
    • at symbol (@)

If the description field does not meet these requirements, the following modifications will be made:

  • More than 18 characters: will be trimmed to take only the first 18 characters
  • Characters other than the allowed character set (above): will be replaced with spaces

Examples

Malformed description

Modified description

PIPER PAY PROPRIETARY LIMITED

PIPER PAY PROPRIET

< PIPER PAY >

PIPER PAY