Payment form override parameters
A set of optional parameters let you override the payment form on a per-transaction basis, taking priority over the merchant-level configuration. Each is sent with the payment request; if omitted, the merchant-level configuration is used.
form_size_override
Overrides the payment form layout for a single transaction instead of using the merchant-level configuration.
| Field | Type | Required |
|---|---|---|
form_size_override |
String | No |
Allowed values
| Value | Description |
|---|---|
only_payment_details |
Form without user data |
only_card_amount_order_details |
Card data, amount, and order no. |
only_card_details |
Card data only |
shortened_card_details |
Logo, header and card data |
buyer_card_details |
Form with user and payment type entry fields |
If not provided, the merchant-level configuration is used. If an unsupported value is sent, the request is rejected with a validation error.
Example
{
"form_size_override": "only_card_details"
}
font_size_override
Overrides the font size of the payment form text for a single transaction.
| Field | Type | Required |
|---|---|---|
font_size_override |
String | No |
Allowed values
| Value | Description |
|---|---|
normal |
Default font size |
large |
Larger font size |
larger |
Largest font size |
If not provided, normal is used. If an unsupported value is sent, the request is rejected with a validation error.
Example
{
"font_size_override": "large"
}
form_duration_override
Overrides how long the payment form stays valid (in minutes) before the session expires, for a single transaction.
| Field | Type | Required |
|---|---|---|
form_duration_override |
Integer | No |
Allowed values
An integer number of minutes, between 1 and 120. If not provided, the merchant-level form duration is used. A value outside the 1–120 range is rejected with a validation error.
Example
{
"form_duration_override": 30
}
dyslexic_font_override
Renders the payment form with a dyslexia-friendly font for a single transaction.
| Field | Type | Required |
|---|---|---|
dyslexic_font_override |
Boolean | No |
Possible values are true or false. If not provided, the merchant-level configuration is used.
Example
{
"dyslexic_font_override": true
}
high_contrast_override
Renders the payment form in a high-contrast colour scheme for a single transaction.
| Field | Type | Required |
|---|---|---|
high_contrast_override |
Boolean | No |
Possible values are true or false. If not provided, the merchant-level configuration is used.
Example
{
"high_contrast_override": true
}
customized_translations_override
Overrides localized UI labels for a single transaction. Takes priority over the merchant-level translation configuration.
| Field | Type | Required |
|---|---|---|
customized_translations_override |
JSON object | No |
Structure
{
"<language_code>": {
"<field_name>": "<value>"
}
}
Supported fields
| Field | Description |
|---|---|
amount_field_title |
Label for the amount field |
store_name_title |
Label for the store name |
order_number_title |
Label for the order number field |
pay_button_caption |
Label for the pay/submit button |
cancel_button_caption |
Label for the cancel button |
Supported languages
hr, en, es, ba-hr, sl, me, sr, sr-Cyrl, mk, de, ro, hu, al, ro-md, ru, bg, cz, gr, it, nl, pl, pt, sk, ar, fr
Validation rules
- Language code must be one of the supported languages listed above.
- Field name must be one of the supported fields listed above.
- Value must be a non-empty string.
- Maximum length per value is 30 characters.
Any request that violates these rules is rejected with a validation error.
Example
{
"customized_translations_override": {
"en": {
"pay_button_caption": "Pay now",
"cancel_button_caption": "Cancel"
},
"hr": {
"pay_button_caption": "Plati sada",
"cancel_button_caption": "Odustani"
}
}
}
Configuration priority
- Request payload override (highest priority)
- Merchant-level configuration