Doubleros — Manuál

English

Slovenčina
Čeština

English

Slovenčina
Čeština

Dark mode

Payment Gateway ​

What it is for ​

The Payment Gateway is the service your customers use to pay an order online — by card, by bank transfer through their bank, or by any other method the gateway offers. Doubleros supports three gateways: Stripe, GoPay and Comgate. An organization always has one active gateway; every form, funnel and the shop of the organization pay through the same one.

Without a gateway an order can still be created, but the customer cannot pay it online.

Where to find it ​

In the left menu click Organization → Integrations. The Integrations page has the integrations as tabs under the heading; click Payment Gateway. Next to the name is a Connected or Not connected label.

Direct address: /dashboard/organization/integrations?integration=payment.

Payment Gateway

Before you start ​

Have the following ready before connecting a gateway:

  1. An account with the gateway — a contract with Stripe, GoPay or Comgate and access to their admin. Doubleros does not open the gateway account for you; it uses your own, and the money goes straight to your account.
  2. Supported currencies — in Organization → Settings → Localization, the Supported currencies field. Payment methods are loaded per currency; an organization with no currency gets the error The organization has no currency configured, payment methods cannot be loaded. Orders can be paid in EUR and CZK.
  3. Permission — Organization → Settings → Edit in the permission matrix (see the Who can do this section below).

What I see on the screen ​

The Payment Gateway panel has three parts:

PartWhat it contains
Gateway choice and credentialsthe Payment gateway field and, below it, the fields of the chosen gateway
Payment methodswhich of the gateway's payment methods your forms offer, per currency
Buttons at the bottomRefresh (loads the payment methods from the gateway) and Save

The Payment gateway field offers None, Stripe, GoPay and Comgate.

Secret keys are shown masked once saved. Below the field is the text *Current: ***1234. Leave empty to keep. — if you leave the field empty, the stored key does not change. The eye icon on the right of the field shows the key you are typing.

How to connect Stripe ​

Before you start: get your Secret key from the Stripe Dashboard. You create the webhook in Stripe during the steps.

  1. In the left menu click Organization → Integrations.
  2. In the tabs click Payment Gateway.
  3. In the Payment gateway field select Stripe.
  4. Paste the Stripe Secret key into Stripe Secret Key.
  5. A Stripe Webhook URL box with an address appears below the fields. Click the copy icon on the right — Copied to clipboard appears.
  6. In the Stripe Dashboard create a new webhook endpoint with this address. Select the events listed in the box: checkout.session.completed and checkout.session.expired. If you also offer payment methods with delayed confirmation (for example bank payments in Stripe), add checkout.session.async_payment_succeeded and checkout.session.async_payment_failed too — Doubleros processes them.
  7. Copy the new webhook's Signing secret from Stripe and paste it into Stripe Webhook Secret.
  8. Click Save at the bottom of the panel.

After saving, Organization was successfully updated appears and Doubleros immediately loads the payment methods from Stripe. The label next to Payment Gateway turns to Connected once both keys are filled in.

FieldRequiredWhat it meansLimits / default
Stripe Secret Keyyesthe Secret key of your Stripe accountmasked after saving; empty field = keep the stored one
Stripe Webhook Secretyesthe webhook signing secret from Stripewithout it Doubleros cannot verify messages from Stripe and orders are not marked as paid
Stripe Webhook URL—the address you enter in Striperead-only, copied with the icon

WARNING

Without a webhook the customer pays, but Doubleros learns about the payment only through its periodic check with the gateway. Always set the webhook so the order turns Paid right away.

How to connect GoPay ​

Before you start: get your GoID, Client ID and Client secret from GoPay. Use the GoPay sandbox credentials for testing.

  1. In the left menu click Organization → Integrations.
  2. In the tabs click Payment Gateway.
  3. In the Payment gateway field select GoPay.
  4. In GoPay environment select Sandbox (testing) or Production.
  5. Fill in GoID, Client ID and Client secret.
  6. If you will sell in instalments and GoPay has already enabled recurring payments for you, switch on Recurring payments are enabled on my GoPay account (see below).
  7. Click Save.
FieldRequiredWhat it meansLimits / default
GoPay environmentyesSandbox (testing) = test payments without money, Production = live paymentsthe credentials must belong to the chosen environment
GoIDyesyour shop's identifier at GoPaya number, e.g. 8123456789
Client IDyesthe login ID for the GoPay API—
Client secretyesthe password for the GoPay APImasked after saving; empty field = keep the stored one
Recurring payments are enabled on my GoPay accountnoyour declaration that GoPay has enabled recurring paymentsoff by default; without it instalments cannot be switched on for forms

With GoPay no notification address is set in its admin — Doubleros sends it with every payment.

The “Recurring payments are enabled on my GoPay account” switch ​

The switch turns nothing on at GoPay — it is your confirmation. The text next to it says: Switch this on only once GoPay has actually enabled recurring payments for your GoID — we do not arrange that for you. Besides the permission itself, have the recurring-payment wording on the checkout approved and switch on Account updater (without it most instalments eventually fail on an expired card). While this switch is off, instalments cannot be turned on for any form.

How to connect Comgate ​

Before you start: in the Comgate portal open your shop's settings, the Shop connections tab, and get the Shop connection identifier and Password.

  1. In the left menu click Organization → Integrations.
  2. In the tabs click Payment Gateway.
  3. In the Payment gateway field select Comgate.
  4. Paste the Comgate Shop connection identifier into Merchant identifier. Note: this is not the MID value from the shop settings.
  5. Paste the connection's Password into API secret.
  6. Leave Test mode on while you test; switch it off before you start selling for real.
  7. If you will sell in instalments and Comgate has enabled recurring payments for you, switch on Recurring payments are enabled on my Comgate account.
  8. Click Save.
  9. After saving, expand the Setup in the Comgate portal box (it is open by itself on the first setup) and do the five steps it lists in the Comgate portal (see the next section).
FieldRequiredWhat it meansLimits / default
Merchant identifieryesthe Comgate Shop connection identifiernot the MID
API secretyesthe connection's Passwordmasked after saving; empty field = keep the stored one
Test modenopayments go to the Comgate test environment, no real money is takenswitch off before selling for real
Recurring payments are enabled on my Comgate accountnoyour declaration that Comgate has enabled recurring paymentsoff by default; without it forms will not offer instalments

What to set in the Comgate portal ​

The Setup in the Comgate portal box in the Payment Gateway panel walks you through five steps. In the Comgate portal open your shop's settings, the Shop connections tab, edit the connection (or add a new one) and set:

Step in the boxWhat to do in the Comgate portal
Identifier and passwordcopy the Shop connection identifier and Password into the fields in Doubleros
Enabled payment establishment typechoose HTTP POST protocol - backend; with any other choice Comgate refuses the payments
Url for payment result transferpaste the address the box shows (copied with the icon); without it the customer pays but the order stays unpaid
IP whitelistpaste the server IP address the box shows; if the box shows no IP, tick Allow all IPs
Url paid, cancelled and pendingcan stay as they are — Doubleros sends its own return addresses

WARNING

The payment result address contains a security token created only when you save. Until you save the settings, the box says The full notification URL, including its security token, is shown after you save the settings. Until the address is filled in the Comgate portal, orders are marked as paid only by the periodic check with the gateway, with a delay.

How to choose the payment methods the customer sees ​

The Payment methods section of the Payment Gateway panel decides which of the gateway's payment methods your forms offer to customers. The list is a stored copy of what the gateway allows — Doubleros does not ask the gateway every time a form opens, only on save, when you click Refresh, and when the gateway or environment changes.

  1. In the left menu click Organization → Integrations → Payment Gateway.
  2. In the Payment methods section select the currency tab (for example EUR or CZK).
  3. Click a tile to switch the payment method on or off (the checkbox on the tile shows the state). Bank-transfer tiles show Banks: N — banks cannot be switched off one by one, the customer picks the bank at the gateway.
  4. Repeat for the other currencies.
  5. Click Save.

Below the section title is the time Last loaded from the gateway: ….

Message in the sectionWhat it means and what to do
Fill in the gateway credentials above and save — …the gateway is not saved yet; fill in the details and click Save
Payment methods have not been loaded yet. …click Refresh
The saved payment methods no longer match the gateway (since …). Load them again.something changed in the gateway admin; click Refresh and then Save
The payment methods shown belong to a different gateway setup than the one selected. …you changed the gateway or environment; fill in the credentials, click Refresh or Save
The gateway allows no payment method for this currency.allow payments in this currency in the gateway admin
No payment method is enabled for … — customers will have nothing to pay with.switch on at least one tile

The “Refresh” button ​

Refresh at the bottom of the panel reloads the payment methods from the gateway. If you have changed the gateway or environment in the fields and not saved yet, Refresh shows what the new gateway offers but stores nothing — Payment methods were loaded from the gateway. They are not saved yet — save the settings. appears. Otherwise Payment methods were loaded from the gateway. appears.

The button is disabled while no gateway is saved (or while the new gateway's credentials are not filled in) and while saving.

How to change the gateway ​

An organization can have one gateway only. A change applies to every form, funnel and the shop at once.

  1. In the left menu click Organization → Integrations → Payment Gateway.
  2. In the Payment gateway field select the new gateway.
  3. Fill in its fields (steps above).
  4. Click Refresh — you see the new gateway's payment methods (not saved yet).
  5. Switch on the payment methods you want.
  6. Click Save.

Orders created before the change stay tied to the original gateway. If you sold in instalments through GoPay or Comgate and the new gateway has no confirmed recurring payments, the forms with instalments stop offering them.

How to disconnect the gateway ​

  1. In the left menu click Organization → Integrations → Payment Gateway.
  2. In the Payment gateway field select None.
  3. Click Save.

Customers can then no longer pay online.

What the customer sees ​

  • In the order form (in a form, a funnel or the shop) the customer picks a payment method from the tiles switched on for the currency they buy in. Card is preselected.
  • After confirming the order, Doubleros redirects them to the gateway page. The gateway page opens in Slovak, Czech or English according to the customer's language.
  • After paying they return to the thank-you page. Whether the order is paid is decided by the message from the gateway (webhook / notification), not by the customer's return.
  • An order with a total of 0 (for example after a 100% discount) is marked paid at once, without the gateway.

How to check it works ​

  1. Use test keys with Stripe, the Sandbox (testing) environment with GoPay, and Test mode switched on with Comgate.
  2. Place a test order on a published sales form and pay it with the gateway's test card.
  3. In the left menu open Sales → Orders. The order should turn Paid within seconds. If it stays Awaiting payment, check the webhook (Stripe) or the Url for payment result transfer (Comgate).
  4. After the test switch the gateway to live details (Production, Test mode off, live Stripe keys) and click Save.

Who can do this ​

ActionRequired permission (permission matrix)
see the Payment Gateway panelOrganization → Settings → View
change the gateway, keys, payment methods, Refresh, SaveOrganization → Settings → Edit

With View only, the fields are disabled and Refresh and Save are off.

Common questions and problems ​

The customer paid but the order is still “Awaiting payment”. Most often the webhook (Stripe) or the Url for payment result transfer (Comgate) is missing, or Stripe Webhook Secret holds a different key than the webhook in Stripe. Doubleros learns about the payment later through its periodic check with the gateway, but set up the notifications so it happens at once.

Message “Settings were saved, but the payment methods could not be read from the gateway. …” The details were saved, but the gateway returned no list of payment methods — usually because of wrong credentials or the wrong environment (sandbox vs. production). Fix them and click Refresh.

Error “Payment methods could not be read from the gateway (…). Check the gateway credentials.” The gateway refused the login for the listed currencies. Check the keys and whether your gateway account allows that currency.

Why can't I switch instalments on in a form? With GoPay and Comgate the Recurring payments are enabled on my GoPay account / Recurring payments are enabled on my Comgate account switch must be on. Nothing needs confirming with Stripe. See Instalment sales.

Can I have Stripe and GoPay at the same time? No. The organization has one active gateway; the choice of payment method happens within it.

I changed the payment methods in the gateway admin and the form does not show them. Doubleros uses the stored copy. Click Refresh and then Save.