Important
New shipment package stream endpoint is available

For large-scale scanning and synchronization flows, please prefer getShipmentPackagesStream.

HomeGuidesAPI ReferenceChangelogSupport Request
Guides
  1. documentation

2. Getting Started

Explore the Trendyol API documentation to integrate your systems with Trendyol. Review service limitations, responses, and integration guides.

Trendyol API documentation contains information about the services through which you can integrate your systems with the Trendyol system.

Before starting with our integration services, we strongly recommend you to carefully review the following sections

You can access our detailed integration service documents by clicking on the links below

What is Trendyol API Integration ?

Trendyol International API Integration allows companies participating in the Trendyol Partner Program (Marketplace) to connect their Trendyol stores to their e-commerce systems through Trendyol API services, allowing them to perform many transactions.

Authorization

❗️

Caution

Since all integration operations can be done through API information, your API key information should not be shared on any open platform (github, gitlab etc.)

Requests to integration services should be authorized with basic authentication method.

supplierid, API KEY and API SECRET KEY information used for Basic Authentication should be obtained from the "Integration Details" page under "Account Details" in the seller panel. This information is visible only to master user of seller panel.

API key information is unique for each supplierId. Authentication information changes in the prod and stage environment. The information should be revised according to the endpoint and environment used. In case of wrong authorization, the message status: 401 , "exception": "ClientApiAuthenticationException" will return.

We have two types of environments: stage and production.

  • Our stage environment allows sellers to perform all the tests they need to integrate their integration services into our systems. Trendyol stage environment needs an IP authorization for access.
  • In prod environment there is no need any IP authorization, however your IP could be added to blacklist for some reason. If any access issue has been faced with both stage and prod environment please contact us.

Stage Environment

Your stage environment account and API information is completely different from your prod environment information.

In order to access the stage environment, the IP information of the application servers should be notified to Trendyol and an access definition should be made. More than one IP definition can be made, defined IPs can be updated later if notified.

(IP authorization required): You can use a shared test account for the test environment or submit your request for a private test account to the support team via Seller Center. For your private test account information, simply provide the email address, phone number, and your company's TCKN/VKN value that you will use to log in to the test environment in your request.


Using Auth and User-Agent

All requests to Trendyol Partner API must have Auth and User-Agent information in the Header. Requests that do not send User-Agent information will be blocked with a 403 error.

If working with an intermediary company as User-Agent information, "Seller Id - {Integration Company Name}", if the integration software belongs to the company, "Seller Id - Self Integration" should be sent.

  • Please send your integrator company name in alphanumeric characters with a maximum of 30 digits.
    Example 1 :
    • sellerId: 1234
      • Integrator company name: TrendyolSoft
        • User-agent information to be sent: "1234 - TrendyolSoft"
    Example 2 :
    • sellerId : 4321
      • If there is no integrator company, The software belongs to the company.
        • User-agent information to be sent: "4321 - SelfIntegration"

Marketplace Integration Services

Marketplace Webhook Services

Prod Environment

The API information you will use to integrate on prod environment, will be given to you by Trendyol team.

Updated 9 days ago