Payment gateways#
How the customer pays. Find them under Systém → Platební brány.
Supported gateways#
| Gateway | Note |
|---|---|
| GoPay | cards, transfer, payment buttons |
| ComGate | cards, transfer |
| PayU | cards, transfer |
| Stripe | cards |
| PayPal | a PayPal account, cards |
| Mobile payments | paying through the operator |
| Credit | internal credit in the system, not real money |
Gateway settings#
| Field | Note |
|---|---|
| Name | what the customer sees; entered per language |
| Handler | which gateway this is; do not change after setup |
| Credentials | merchant identifier, key, password |
| Fee in percent | added to the payment |
| Konečné ceny (final prices) | this gateway's prices are final — no VAT and no rounding to the currency precision is added |
| Active | a disabled gateway is not offered |
| For guests | whether an unregistered visitor may pay through it |
Gateway credentials are a secret
They are visible in the gateway's edit form — just blurred until you click to reveal them. Only a role with full-scope permissions (the role's "privileged" flag) can see them; other administrators see them blurred out. Do not email them or paste them into a description. Whoever obtains them can redirect your payments.
Do not change the handler once a gateway is live
It is a choice of type, not a label. Switching it on a gateway that has already taken payments means nobody can reach the old ones.
Test and live mode#
Most gateways have a test environment. It is part of the credentials — test keys lead to the test gateway.
Verify which mode you are in before letting people pay
A test gateway looks identical and payments go through it. The money never arrives, while the system treats it as paid. After switching to live keys, pay one real unit of currency and check it on your statement.
Fees#
The fee is set as a percentage on the gateway and as a fixed amount in the fee table. The two can be combined.
The fee is visible to the customer
It is added to the amount. To bear it yourself, leave it at zero and build it into your prices.
Final prices#
The Konečné ceny (final prices) checkbox says whether the prices entered for this gateway are already final. The administration spells it out: "This gateway's prices are final — no VAT and no rounding to the currency precision is added; the amount goes into the payment 1:1 (premium SMS, credits)."
| Checkbox | What the system does with the price-list price |
|---|---|
| off (ordinary gateways) | for a VAT-registered seller it adds the tax, then rounds the sum to the currency's decimal places |
| on | nothing — the amount goes into the payment exactly as entered |
It is ticked on Mobilní platby (premium SMS levels are set by the operator and are final, VAT included) and on Kredit (an internal currency — the tax was settled when the credit was bought, adding it again would tax it twice). Prices for such a gateway are entered on the tariffs directly as the amount to be paid, and the base excluding tax is worked out only on the document.
Step by step: turning final prices on for a gateway#
- Open Systém → Platební brány and the gateway's edit form.
- Tick Konečné ceny and save.
- Go through the tariffs and rewrite the prices for this gateway to the amounts that should actually be charged — no tax will be added to them any more.
- Open the payment form on the site and check that the total matches what you entered.
Do not enable it on a card or transfer gateway
Tariff prices are entered as a base excluding VAT. With final prices on, the tax is not added and a registered seller pays it out of their own pocket — at a 21 % rate that is a fifth of every payment. On the document the base is then worked out backwards, so the discrepancy is not obvious at a glance.
Do not disable it on premium SMS
The system pairs an incoming SMS with the payment by the amount, with a tolerance of 0.001. Added tax or rounding shifts the level and no premium number matches the amount: either the customer is not offered anywhere to send the SMS, or the SMS that is sent is evaluated as a "wrong number" and the payment ends as failed.
Switching it takes effect only on new payments
Payments already created hold their own amount and are not recalculated. Check any payments in progress before you change the checkbox.
Regions#
A gateway is enabled per payment region. Customers see only the ones allowed for their region.
A gateway with no region shows to nobody
It is the most common reason no payment method appears in the cart. Check the region assignment before checking the credentials.
Credit is not a gateway in the usual sense#
Credit deducts the user's internal balance. No money is transferred anywhere.
Credit is usually not invoiced
The document was issued when it was bought. Currencies meant for this carry a flag that no document is issued from them — see the invoicing settings.
The system knows it is credit from the currency, not from the gateway
The credit gateway keeps its price list in an internal currency (KRD here), and
that currency has the Interní měna (internal currency) switch on — which is why
amounts are printed as "200 credits" instead of a money format and VAT is never
mentioned for them. See
Currencies, VAT and units.
When a payment does not go through#
- Is the gateway active and assigned to the customer's region?
- Are the credentials right, and are they live?
- What is in the communication with the gateway on that payment?
- Is the callback arriving? See Regions and callbacks.