Connecting a Trendyol Store
A Trendyol integration is an overlay on an existing store. Create the store first (Settings → Stores), then attach Trendyol credentials to it.
Navigate to Marketplaces → Trendyol → Stores.
Connected Stores
The stores list shows every store with a Trendyol overlay, including whether credentials are on file and whether the integration is active.
For security, API credentials are encrypted at rest and never returned by the API. The UI shows a "configured ✓" indicator (via HasApiKey / HasApiSecret) rather than the secret value.
Credentials
Open a store to edit its Trendyol overlay. Provide the values from your Trendyol Seller (Partner) account:
| Field | Description |
|---|---|
| Environment | Production or Sandbox (staging) |
| Seller ID | Your Trendyol Seller / Supplier ID |
| API Key | Trendyol integration API key |
| API Secret | Trendyol integration API secret |
| User Agent | Integration user-agent string Trendyol requires on API calls |
| Storefront Code | Marketplace storefront code (defaults to TR) |
| Active | Enables catalog push, order pull, and sync workers for this store |
On update, leaving API Key or API Secret blank keeps the previously stored value unchanged. To clear a stored credential, use the explicit clear action in the UI rather than submitting an empty value.
Fulfillment & Shipping Settings
These values control how orders and shipments are handled for the store:
| Field | Description |
|---|---|
| Shipment Address ID | Trendyol address ID used as the dispatch origin |
| Returning Address ID | Trendyol address ID used for returns |
| Default Cargo Company ID | Fallback carrier when an order has no carrier assigned |
| Fulfillment Model | How orders are fulfilled (e.g. seller-shipped vs. marketplace-fulfilled) |
Test the Connection
After saving credentials, use Test Connection. Quark makes a seller-scoped probe call to Trendyol and reports:
- Success / failure
- HTTP status code
- Message and the raw response for diagnostics
Resolve any authentication or permission errors here before activating the integration.
Activation
Set the overlay Active once the connection test passes. While inactive, no catalog push, order pull, or sync runs for the store — useful while you finish taxonomy mapping.
Removing an Integration
Deleting the overlay clears the Trendyol credentials and settings from the store. The store itself and its catalog are unaffected.