Field Validation
Following list describes the accepted types for fields and their maximum length in parentheses.
MERCHANT_ID
Numeric string. (11)
CURRENCY
Only EUR
accepted. (3)
URL_SUCCESS
Valid URL including http(s). URLs that do not include any dots (e.g. http://localhost) are currently not supported. (2048)
URL_CANCEL
Valid URL including http(s). URLs that do not include any dots (e.g. http://localhost) are currently not supported. (2048)
ORDER_NUMBER
0-9, a-z, A-Z and ()[]{}*+-_,
. As regular expression /^[0-9a-zA-Z()[]{}*+-_,.]{1,64}$/
. (64)
AMOUNT
Float between 0.65–499999.99
(10)
If you need to receive transactions that are less than 0.65€, please contact our customer service https://paytrail.com/en/contact.
PARAMS_IN
0-9, A-Z, [],_
. (4096)
PARAMS_OUT
0-9, A-Z, [],_
. (255)
ALG
1
. (2)
AUTHCODE
0-9, A-Z
. (64)
URL_NOTIFY
Valid URL including http(s). URLs that do not include any dots (e.g. http://localhost) are currently not supported. (2048)
PARAMS_OUT_NOTIFY
0-9
, A-Z
, [],_
. (255)
LOCALE
fi_FI
, sv_SE
, and en_US
. As regular expression /^[a-z]{1,2}[_][A-Z]{1,2}$/
. (5)
REFERENCE_NUMBER
Alphanumeric, either numeric value complying Finnish reference number standard or numeric Finnish reference number in international RF format (e.g. 1232 or RF111232). (20)
PAYMENT_METHODS
0-9
and ,
(64)
VAT_IS_INCLUDED
0
, 1
. (1)
MSG_SETTLEMENT_PAYER
Unicode alphabets and ()[]{}*+-_,.\"'
. As regular expression /^[pL-0-9- \"',()[]{}*+-_,.]*$/u
. (255)
MSG_SETTLEMENT_MERCHANT
Unicode alphabets and ()[]{}*+-_,.\"'
. See regular expression from MSG_SETTLEMENT_PAYER
. (255)
MSG_UI_PAYMENT_METHOD
Unicode alphabets and ()[]{}*+-_,.\"'
. See regular expression from MSG_SETTLEMENT_PAYER
. (255)
MSG_UI_MERCHANT_PANEL
Unicode alphabets and ()[]{}*+-_,.\"'
. See regular expression from MSG_SETTLEMENT_PAYER
. (255)
PAYER_PERSON_FIRSTNAME
Unicode alphabets and ()[]{}*+-_,:&!?@#$£=*;~/\"'
. As regular expression /^[pL-0-9- \"',()[]{}*/+-_,.:&!?@#$£=*;~]*$/u
. (64)
PAYER_PERSON_LASTNAME
Unicode alphabets and ()[]{}*+-_,:&!?@#$£=*;~/\"'
. See regular expression from PAYER_PERSON_FIRSTNAME
. (64)
PAYER_PERSON_EMAIL
example@domain.org
, max length for example
is 64. (255)
PAYER_PERSON_PHONE
0-9
, +-
. As regular expression /^[0-9+\-]*$/u
(64)
PAYER_PERSON_ADDR_STREET
Unicode alphabets. As regular expression /^[\pL-0-9- \"\',. ]*$/u
. (128)
PAYER_PERSON_ADDR_POSTAL_CODE
0-9
, a-z
, A-Z
. (16)
PAYER_PERSON_ADDR_TOWN
Unicode alphabets and ()[]{}*+-_,:&!?@#$£=*;~/\"'
. See regular expression from PAYER_PERSON_FIRSTNAME
. (64)
PAYER_PERSON_ADDR_COUNTRY
a-z
, A-Z
. (2)
PAYER_COMPANY_NAME
Unicode alphabets and ()[]{}*+-_,:&!?@#$£=*;~/\"'
. See regular expression from PAYER_PERSON_FIRSTNAME
. (128)
ITEM_TITLE
Unicode alphabets and ()[]{}*+-_,:&!?@#$£=*;~/\"'
. See regular expression from PAYER_PERSON_FIRSTNAME
. (255)
ITEM_ID
0-9
. (16)
ITEM_QUANTITY
Floating point number. (10)
ITEM_UNIT_PRICE
Floating point number. between –499 999.99 – 499 999.99
. (10)
ITEM_VAT_PERCENT
Floating point number. between 0-100
. (10)
ITEM_DISCOUNT_PERCENT
Floating point number. (10)
ITEM_TYPE
1
, 2
, and 3
. (1)
EXPIRATION_FOR_PAYMENT_CREATION
ISO-8601 notation datetime with time zone. For example, yyyy-mm-ddThh:mm:ss+-hh:mm
(2018-08-18T22:09:17+02:00
). (25)