Managing Integrations (List, Setup, Turning On/Off)

Where to find: Left menu → Integrations Who it's for: Those setting up a service (payment, shipping, analytics, etc.) for the first time, or wanting to change the settings of an existing integration. In short: You click an integration's card, enter the keys in the window that opens, turn it on/off with the Enable Integration switch and press Save.

What does it do?

This page explains step by step how the Integrations screen works: how integrations are listed, what the cards mean, how an integration is configured and enabled, and the warnings you may encounter.

1. Overview of the page

At the very top of the page there is a title (Integrations) and below it the description "Manage your store integrations".

Right below it there is a search box: "Search integrations...". The text you type here instantly filters the list by the integration's name or description. For example, if you type "shipping" only the shipping integrations remain.

Below the search box, the integrations are listed one below the other in category sections. The sections always come in this order: Payment → Shipping → Analytics → Site Verification → Social Login → Security → Email → AI → E-Invoice → Marketplaces → Social Media. A category with no integrations is not shown.

At the start of each category section there is: a colored icon, the category name (for example Payment) and its short description (for example "Payment providers and payment methods"). Below it, the integration cards of that category are arranged in a card grid.

2. Reading an integration card

Each card represents a single service. A card contains the following:

When you hover over the card, an arrow (›) appears on the right side. Clicking the card opens that integration's configuration window in the middle of the screen.

3. Configuring an integration (entering the settings)

1. Click the card of the relevant integration. A window opens in the middle of the screen.
2. At the top of the window the service's logo, name and description appear. Some integrations also show a "Setup guide: how to get the key / token" link right below; it opens the related help page in a new tab.
3. In the window, the input fields specific to that service are listed. These fields differ for each service; for example, a payment provider asks for an API Key and Secret Key, while a shipping company asks for a Username and Password. Required fields have a red asterisk (*) next to them. Some fields have a short note under them telling you where to find the value in the service's dashboard.
4. Fill in the fields. Some fields may be a dropdown list (for example Test Mode on/off) or a toggle switch.
5. Press the Save button at the bottom of the window. If successful, the notification "Settings saved" appears and the window closes. If you want to cancel, press Cancel.

If a required field is empty or a value isn't in the expected format, nothing is saved; the reason is shown in red under the field (e.g. "This field is required.").

In the Email, Security and Social Media categories there is also a Test Connection button at the bottom of the window: it tries the information you entered with the service before saving and shows the result as a notification. If you left the field of a saved password or key empty, the test uses the saved value.

To see in advance exactly which fields each integration asks for, check the Provider Catalog (Which Integration Asks for What?) page.

Special case: Test Mode

Many payment and shipping integrations have a Test Mode (in some places "Sandbox") switch. When it is on, transactions are not real but done in a trial environment. When you go live with real sales, don't forget to turn off this switch.

Special case: Havale / EFT — bank accounts

In the Havale / EFT integration in the Payment category, instead of entering keys, you add your bank accounts. In the window, from the Bank Accounts section, using Add Account you enter the Bank, IBAN and Account Holder information for each account.

• The IBAN must start with TR followed by 24 digits; otherwise the warning "Enter a valid IBAN (TR + 24 digits)" appears.
• These accounts are shown to your customer when they select "Havale/EFT" at the payment step.

Special case: PayTR notification (webhook) address

In the PayTR integration, a special notification URL is shown in the window for you to copy. You need to paste this address into the notification/webhook settings in PayTR's own store panel; otherwise the payment results will not reach your store properly.

4. Enabling / disabling an integration

In the configuration window, below the input fields, there is a toggle switch titled Enable Integration.

• When you turn on the switch and press Save, the integration goes live.
• When you turn it off and press Save, it stops; your settings are not deleted, they are kept.

5. "Settings updated" warning (schema update)

When you open an integration's window you may see a yellow warning at the top: "This integration's settings have been updated. Please review the configuration."

This means the fields that the integration asks for have been updated on Treyza's side. A new field may have been added or changed. If you see this warning, all you need to do is review the fields and press Save again.

Frequently asked questions

I saved but the integration is not working, what should I do? First, make sure the Enable Integration switch is on. Then check that the keys were copied correctly and the state of test mode. If you still have a problem, re-verify the information you entered from the service's panel.

Can I keep more than one integration on in the same category? In categories that show the "Only one integration can be active for this category" warning, no; single selection is required. In categories that do not show this warning (for example Analytics, Shipping), you can keep more than one on at the same time.

Can I later see the password/key I entered? No. For security, saved passwords and keys are never shown in clear text again: when you open the window again the field is empty and only its last four characters are shown under it (e.g. "Saved key: ••••1234"). To change it, paste the new value into the empty field and press Save. If you don't want to change it, leave the field empty; the saved value is kept. To remove an optional password or key completely, use Remove next to that line: the line then says "Will be removed when you save" and the value is deleted when you press Save. To cancel, press Undo; pasting a new value into the field also cancels the removal, and the new value is saved. Required fields (marked with *) have no Remove; you can only replace them with a new value.