Managing Integrations (List, Setup, Turning On/Off)
You click an integration's card, enter the keys in the panel that opens, save them, and turn it on/off with the Enable Integration switch.
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 panel that opens, save them, and turn it on/off with the Enable Integration switch.
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 → Email → AI → E-Invoice → Marketplaces. 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.
Tip: If you cannot find what you are looking for, either there is no integration defined in that category yet, or the word you typed in the search box does not match. If the search returns nothing, the text "No results found" appears; if there are no integrations at all, the text "No integrations yet" appears.
2. Reading an integration card
Each card represents a single service. A card contains the following:
| Item | Meaning |
|---|---|
| Logo | The service's logo (if there is none, the category's icon is shown) |
| Name | The service's name (for example iyzico, Trendyol) |
| Global label | Indicates that this integration's setting is kept shared across all your stores (at the account level) |
| Green check | Indicates that the integration is currently on/enabled |
When you hover over the card, an arrow (›) appears on the right side. Clicking the card opens that integration's configuration panel from the right.
Tip: To tell whether an integration is on, look at the green check on the right of the card. If there is no check, the integration is off (it will not work even if you have entered its settings).
3. Configuring an integration (entering the settings)
- Click the card of the relevant integration. A panel opens from the right.
- At the top of the panel the service's logo, name and description appear.
- In the panel, 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. - Fill in the fields. Some fields may be a dropdown list (for example Test Mode on/off) or a toggle switch.
- Press the Save button at the bottom of the panel. If successful, the notification "Settings saved" appears. If you want to cancel, press Cancel.
To see in advance exactly which fields each integration asks for, check the Provider Catalog (Which Integration Asks for What?) page.
Warning: The API keys and passwords you enter are sensitive information. If entered incorrectly or incompletely, the integration will not work (for example, payments cannot be taken). Make sure you copied the keys from the service's official panel and did not leave any extra spaces.
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.
Warning: No real payments are taken while Test Mode is on. When your store goes live, be sure to check that test mode is off in your payment and shipping integrations.
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 panel, 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 panel 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
At the top of the configuration panel there is a toggle switch titled Enable Integration.
- When you turn on the switch, the integration goes live.
- When you turn it off, it stops; your settings are not deleted, they are kept.
Warning: For some categories the following warning appears on the screen: "Only one integration can be active for this category." This means that in that category (for example Payment, Email, AI, E-Invoice) only a single integration can stay on at a time. If you turn on a new one, the previously on integration in the same category is automatically turned off. You can see whether single selection is required in a category from the table on the Provider Catalog (Which Integration Asks for What?) page.
5. "Settings updated" warning (schema update)
When you open an integration's panel you may see a yellow warning at the top: "This integration's settings have been updated. Please check 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? Sensitive fields are hidden for security. If you need to change them, you can fill in the field again and save.
Integrations — Overview
This is where you connect Treyza to external services (payment provider, shipping company, Google Analytics, e-invoicing, etc.), enter their keys and…
Provider Catalog (Which Integration Asks for What?)
A category-by-category list of all integrations that can be set up in Treyza; the information each one asks of you and whether the "single selection…