What is a connection in Zru?

Zru is a payment method aggregator. But beyond connecting to payment processors, it also lets you connect to other tools: antifraud, chargeback management, Agnostic 3DS, Network Token, and more.

That is why the section is called Connections and not simply "payment methods": you can use it to add both processors and payment management tools, all with a few clicks from the panel.

Throughout this guide we will use the term "provider" to refer to both payment methods and tools.

The difference between a Connection and a Payment method

In the panel we distinguish between a connection and a payment method to make management easier. Everything is grouped by provider.

Some key points:

• A connection can hold one or more payment methods.
• There are connections without payment methods, such as Agnostic 3DS, which is a service provider rather than a payment provider.
• Payment methods always live inside a connection.
• Credentials are entered once at the connection level, not for each payment method separately.

Some examples:

• Redsys is a connection with three payment methods: Card, Bizum and Card Redirect.
• dLocal is a connection with several payment methods: Card, dLocal Redirect, 7-eleven, and more.
• Inespay is a connection with a single payment method: Transfer.
• Agnostic 3DS is a connection without payment methods.

Before you add a connection

Zru is a technology platform: it connects you with the provider, but first you need an account with them.

• In some cases we have agreements with the provider and can put you in touch directly. You will see it when you add the connection: the "Partner" label appears.
• In other cases we handle it ourselves and you do not need an account with any external provider, as is the case with Agnostic 3DS or Network Token.

Once you have an account with the provider, they will give you credentials that you enter in the panel to set up the connection.

✋ Keep in mind that depending on the region or country where your company is based, you may or may not be able to use some providers, since each one operates in specific countries.

The Connections list

Go to the Connections section in the left-hand menu. You will see two tabs: Active and Disabled.

You can search by connection or method name, and narrow things down with the All categories and All currencies filters. The Export CSV button downloads the list.

The list columns are:

• Connection: the provider name.
• Category: the connection type (Processor, Banking, BNPL, Marketplace, Security, etc.).
• Payment methods: methods active within that connection.
• Usage: two icons showing whether the connection is being used in orchestrations and/or Checkouts. Hovering over each icon shows a tooltip with the specific names.
• Connection date: when it was added.

How do I add a connection?

Adding a connection is done in a dedicated step-by-step view.

Step 1 — Select the connection

• Go to the Connections section in the left-hand menu.
• Click "New connection".
• Search for the connection you want by name, or narrow it down with the currency and category filters.
• Each card shows the provider, a short description, its category and the payment methods it supports. If we have an agreement with the provider, you will see the "Partner" label.
• Click the connection you want.

Step 2 — Set up the credentials

A side panel opens with the connection settings.

• Enter the name the connection will show at checkout.
• In the [provider] credentials block, fill in the credentials you were given.

✋ If you are in a test environment, enter the test credentials. If it is a production environment, enter the production ones.

In test environments, if the processor supports it, you can choose between two options:

• My credentials: use your own test credentials from the processor. Choose this if you already have an active account with them.
• Zru credentials: Zru provides the sandbox credentials. Useful for getting started without your own account at the processor.

Depending on the provider you will see specific fields and options (for example, enabling or forcing 3DS). If you want to assign your own identifier to the connection, expand Advanced settings and fill in the Internal code field.

• Click "Continue".

Step 3 — Add the payment methods

In the Add payment methods side panel:

• Select the methods you want to activate, or use "Select all".
• Click "Add methods".

The connection is created active by default. You will see a notice inviting you to start operating by adding the connection to your Orchestrations or Checkouts.

The connection detail

When you click a connection you will see its detail. The header shows the Connection (provider), the Category, the Usage in orchestrations and Checkouts, the Connection date and its status.

Below is the Payment methods section, with its own search and filters (All statuses, All currencies). For each method you can check:

• Usage: how many orchestrations and Checkouts it is used in.
• Payments / Acceptance: the number of payments processed and their acceptance rate.
• Currencies: the currencies the method operates in.
• Last modified: when it was last updated.
• Status: enable or disable the method with the toggle, without leaving the table.

From here you can also delete a method with the trash icon.

🧐 If a connection has no active methods, the panel reminds you to add one so the connection can start operating.

Advanced settings of a connection

Inside the connection detail, click "Settings" at the top right. A panel opens with the Advanced settings accordion, which includes the Internal code field.

🧐 The internal code is sent in the notification inside _gateway, in the internal_code field. It is useful when you need to identify which connection a payment comes from in your own systems.

You can also fill in this field while creating the connection, in the credentials step.

How do I enable or disable a connection?

To disable a connection

• Go to the Connections section in the left-hand menu.
• Click the connection you want to disable, inside the Active tab.
• Click "Settings" at the top right and turn off "Connection status" at the bottom of the module.
• Click "Update".

The connection moves to the Disabled tab.

To enable a connection

• Go to the Connections section in the left-hand menu.
• Click the Disabled tab.
• Click the connection you want to enable.
• Click "Settings" at the top right and turn on "Connection status" at the bottom of the module.
• Click "Update".

✋ Keep in mind that enabling the connection does not automatically enable the methods it contains. You need to open the connection and enable the methods you want with the Status toggle.

How do I edit a connection?

• Go to the Connections section in the left-hand menu.
• Click the connection you want to edit.
• Click "Settings" at the top right.
• Change the parameters you need.
• Click "Update" to save the changes.

Can I delete a connection?

It is currently not possible to delete a connection. If you no longer need it, keep it disabled. You can always enable it again whenever you want.

Where can I use connections?

The payment methods of each connection (or the connection itself, if it is not a payment processor) will be available as an option when you configure your Orchestrations and your Checkouts.

Updated on: 30/06/2026