Settings
Open Tatra CardPay in the Control Panel nav (tatrapay/settings). Settings
are grouped into five sections, all sharing the same Enable Tatra CardPay
and Sandbox Mode switches (right-hand meta panel) and a Test
Credentials action (top action bar), which calls the TatraPay Plus API to
verify the configured API Key / Client Secret and reports success or failure
as a CP flash message.
Complete sandbox validation before switching to live mode.
General (tatrapay/settings/general)
Display labels shown to customers at checkout:
| Field | Purpose |
|---|---|
| Display Name | Label for the card payment method. |
| Display Loan Name | Label for the PayLater / instalment loan option. |
| Display Bank Transfer Name | Label for the Bank Transfer option. TatraPay Plus API only. |
| Display QR Pay Name | Label for the QR Pay option. TatraPay Plus API only. |
| Select button name | Checkout button label used to select this method. |
| Instructions | Free text shown to the customer at checkout. |
Credentials (tatrapay/settings/credentials)
Payment Type selects the integration mode and determines which credentials are required and which payment methods can be offered:
- Tatra CardPay — requires Merchant MID and Secret Key. MID must
match
^[a-z0-9]{3,4}$; the request fails with a plugin log entry (api-service:prepare) if it does not. - Tatra PayPlus API — requires API Key / Client ID and Shared
secret / Client secret. These are used to obtain an OAuth2 access token
(
client_credentialsgrant) before every API call. This mode unlocks PayLater, Bank Transfer, and QR Pay.
Both credential sets can be filled in at once; only the selected Payment Type's credentials are validated and used.
Pricing (tatrapay/settings/pricing)
| Field | Purpose |
|---|---|
| Default currency | ISO 4217 numeric code, used for the classic CardPay request. TatraPay Plus API payments are always sent in EUR regardless of this setting. |
| Default language | Used when no browser language preference is available. |
| Enable TatraPay PayLater | Shows the instalment loan option at checkout. When on, PayLater minimum amount becomes required and must be between 100 and 2000 (ApiService::TATRA_PAY_LATER_MINIMAL_AMOUNT / TATRA_PAY_LATER_MMAXIMAL_AMOUNT). |
| Enable TatraPay Bank Transfer | Shows the Bank Transfer option at checkout. TatraPay Plus API only — has no effect while Payment Type is Tatra CardPay. |
| Enable TatraPay QR Pay | Shows the QR Pay option at checkout. TatraPay Plus API only — has no effect while Payment Type is Tatra CardPay. |
Restrictions (tatrapay/settings/restrictions)
- Visible From / Visible To — optional date/time window during which the payment method is offered at checkout.
- Available in countries — multi-select restricting the method to specific store countries. Empty selection means all countries.
Test cards (tatrapay/settings/test-cards)
Reference sandbox card numbers for validating the CardPay/TatraPay Plus flow end to end. The table is only meaningful while Sandbox Mode is enabled; a notice is shown otherwise. Cards documented here never process real transactions. For additional sandbox scenarios, consult Tatra banka's own integration documentation or their integration support.
Dashboard
Transaction KPIs, trend, and recent activity moved to a dedicated page — see Dashboard.