Shopify shipping integration is a critical infrastructure step that automates the order-logistics processes of e-commerce stores in Turkey and eliminates the time loss and error costs caused by manual shipping management. A properly configured integration automatically manages the entire process, from order confirmation to shipping label generation, tracking number delivery to the customer, and delivery notifications.
In this guide, we address the Shopify integration methods, pre-integration preparation steps, pricing models, and solutions to common problems for Yurtiçi Kargo, Aras Kargo, MNG Kargo, Sürat Kargo, and PTT Kargo, based on the realities of e-commerce in Turkey.
What is Shopify Shipping Integration and Why is it Necessary?
Shopify shipping integration is a connection that establishes real-time data flow between your store's order management system and the shipping company's API infrastructure. Without this connection, each order requires manually creating a shipping label, entering the address into the shipping system, and copying the tracking number to send to the customer—a repetitive process taking 3–6 minutes per order.
A store processing 100 orders daily in Turkey spends an average of 2–3 hours per day on shipping operations without integration. A properly set up Shopify shipping integration reduces this time by 85%. The error rate from manual data entry, which was around 3–5% before integration, drops below 0.2% after integration.
The Turkish e-commerce market reached a transaction volume of 1.3 trillion TL in 2024. In a market of this scale, operational speed and accuracy directly affect customer satisfaction and repeat purchase rates. A shipment sent to the wrong address creates an average additional cost of 180–250 TL, while a customer who does not receive a delay notification is likely to leave a negative review and not place another order.
Shipping integration is not just an operational convenience; it is a strategic investment that protects revenue during scaling.
Shipping Companies in Turkey and Shopify Compatibility
There are five main shipping companies in Turkey that can integrate with Shopify stores: Yurtiçi Kargo, Aras Kargo, MNG Kargo, Sürat Kargo, and PTT Kargo. The level of Shopify compatibility, integration method, API access conditions, and minimum volume requirements vary significantly between these companies.
Yurtiçi Kargo
Domestic Cargo is one of the major Turkish shipping companies with an official app on the Shopify App Store. Its OAuth 2.0-based API integration allows up to 10,000 API calls per day. Since there is no minimum volume requirement, it can be easily set up for newly opened stores. With a network of over 780 branches across Turkey, it stands out in terms of access to second and third-tier cities in Anatolia.
You can review the Yurtiçi Kargo Shopify Integration Setup Guide for step-by-step installation instructions.
Aras Kargo
Aras Kargo offers both an official Shopify app and a third-party middleware integration option. A customer number and API password are required for API access; this information is provided via the B2B portal or representative after signing a corporate contract. Aras, one of Turkey's largest shipping networks, is known for its fast delivery capacity with over 900 branches. The API password can be renewed every 90 days as per security policy; this is a point that requires regular monitoring after integration.
For technical setup steps, you can read the Aras Kargo Shopify Integration Guide.
MNG Kargo
MNG Kargo does not have an official app in the Shopify App Store, but it can be used with apps or provided through middleware platforms or custom API development. Since standard API access may be limited for stores with less than 500 shipments per month, a contract should not be signed without inquiring about the volume threshold. It has a strong distribution network in major cities, particularly Istanbul, Ankara, and Izmir.
For middleware setup steps, you can review the MNG Kargo Shopify Integration Guide.
Sürat Kargo
Sürat Kargo's Shopify integration is set up through third-party applications or middleware. A monthly commitment of 300 shipments is generally the expected minimum threshold for the agreed-upon price. It is one of the few shipping companies offering same-day delivery in Istanbul and Ankara.
PTT Kargo
PTT Kargo does not have an official Shopify app or advanced API infrastructure. Integration is only possible through custom API development or manual processes. While the lack of a minimum volume requirement and access to individual rates are advantages for small stores, automation is limited due to restricted API support. For high-volume stores, Yurtiçi or Aras remain more suitable options.
Preparing for Shopify Shipping Integration
There are three essential preparatory steps that must be completed before starting the shipping integration: signing a corporate agreement with the shipping company, obtaining API access information, and configuring Shopify store settings for integration. If any of these steps are omitted, critical errors will occur during setup or with the first orders.
1. Corporate Agreement and API Access
To access the shipping company's API, a corporate customer contract must first be signed. The process takes 3–5 business days for Yurtiçi and Aras, while it can take 5–10 business days for MNG and Sürat. Once the agreement is finalized, the following information is obtained through the company's corporate portal or customer representative: customer code, API key/password, branch code (mandatory for some companies), sandbox and production endpoint URLs.
⚠️ CAUTION: Never share API keys with third parties and avoid storing them in plain text in the Shopify admin panel. Shopify's Metafields structure or environment variables can be used to store this information securely.
2. Shopify Store Preparation
Before integration, the following three settings must be verified in the Shopify admin panel: First, shipping regions for Turkey must be defined in Settings → Shipping and delivery. Second, weight information must be entered completely for all products; missing weight information prevents label production or causes incorrect price calculations. Third, the VAT configuration must be completed in the tax settings. For stores with more than 500 products, you can perform bulk weight updates using the CSV export/import method.
3. Sandbox Test Environment Setup
Before moving to the production environment, create at least 10 test orders using the shipping company's sandbox API. During this process, verify that the shipping label is generated correctly, that the tracking number is reflected in the Shopify order details, and that webhook notifications are triggered. You may need to request sandbox access separately from your corporate representative; mention this step in advance during contract negotiations.
Shopify Shipping Integration Methods
Shopify shipping integration can be set up using three different methods: the official Shopify App Store application, a third-party middleware platform, and custom API development. Choosing the right method depends on your order volume, technical infrastructure, and the number of different shipping companies you will be working with.
💡 TIP: If you process fewer than 200 orders per month, the official Shopify app is free and sufficient. If you need a volume of 500+ orders or multiple shipping companies, middleware or custom API integration offers a much more efficient solution.
Method A: Setup with the Official Shopify App
The official Shopify apps for Yurtiçi and Aras Kargo can be downloaded for free from the App Store. The setup steps follow a similar process for both companies:
- Go to Shopify admin → Apps → App Store, search for the shipping company's name.
- Install the app by clicking the 'Add app' button and approve the necessary permissions.
- Enter the API information (customer number, password, branch code) in the app settings.
- Verify the API connection using 'Test Connection'; a green checkmark indicates a successful connection.
- Define shipping zones and pricing rules for Turkey in the Shipping Zones section.
- Create a test order, generate the label, and verify that the tracking number has been added to the order.
Method B: Setup with Middleware
For those who want to manage MNG Kargo, Sürat Kargo, or multiple companies from a single panel, middleware platforms such as Geliver, Entegrasyonum.com, or Netgsm are required. These platforms offer multi-company support, automatic courier selection, ERP/WMS integration, and advanced reporting tools for a monthly subscription fee of $20–80.
The basic workflow for middleware setup is as follows: The Shopify store is connected to the platform via OAuth; then, API information for each shipping company is entered into the platform. When an order arrives, the platform automatically selects the relevant shipping company and creates the label according to your specified rules (region, weight, cost).
Method C: Custom API Development
This is the most flexible solution for corporate stores that process more than 2,000 orders per month, need to integrate with ERP or WMS, or require fully customized warehouse workflows. The shipping company's REST API connects directly to Shopify webhooks; middleware costs are eliminated, and the workflow can be customized without limits. At Nodus Works, we also manage this type of corporate integration project.
Shipping Pricing and Automatic Calculation in Shopify
Shopify shipping pricing is configured with two models: fixed price and weight-based calculation. Which model is appropriate depends on your order profile and Shopify plan selection.
Flat Rate and Conditional Free Shipping
This is the most commonly used model. A fixed shipping fee for all orders is defined in Settings → Shipping and delivery → Shipping zones; free shipping kicks in when a certain order amount is exceeded. The vast majority of SMEs in Turkey use a free shipping threshold between 300–600 TL. To set the free shipping threshold correctly, base it on your average cart value and set the threshold 15–20% higher; this ratio encourages customers to add additional products while maintaining the conversion rate.
Weight-Based Pricing
Different price tiers are defined based on product weight; for example, 39.90 TL for 0–1 kg, 59.90 TL for 1–3 kg. For this model to work, all products must have their weight information entered completely in the Shopify admin panel. Also consider the desi (volumetric weight) calculation used by Turkish shipping companies: the shipping company bills the greater of the actual weight and the volumetric weight (length × width × height / 3000).
Post-Integration Testing and Validation
At least five scenarios must be tested before the shipping integration goes live: standard order, heavy/bulky order, delivery to different cities, return order, and canceled order. Skipping these tests will inevitably lead to errors affecting customers in the live environment.
⚠️ WARNING: Create test orders with real products and real Turkish addresses. Most Shopify shipping apps and middleware platforms cannot generate labels or calculate prices correctly for fake addresses.
Test Checklist
- Does the shipping label generate automatically when the order is confirmed?
- Is the tracking number visible on the order details page and in the customer confirmation email?
- Does the tracking number work on the shipping company's website?
- Are webhook notifications triggered correctly? (shipping received, in transit, delivered)
- Does the system respond correctly when a return request is created?
- Is the price calculation accurate and consistent across different weight ranges?
- Are deliveries to different provinces compliant with region-based rules?
Common Issues and Solutions
The four most common issues encountered in Shopify shipping integration are API authentication errors, inability to generate labels, tracking numbers not being added to orders, and incorrect shipping cost calculations. All of these issues can be resolved in a few steps.
Issue 1: Unable to Establish API Connection
Solution: Obtain the latest version of the API information (customer code, password, endpoint URL) from the shipping company's portal. Some companies, including Aras Kargo, automatically renew the API password during security updates; the old password in the Shopify app causes a connection error. Check if there are any hidden space characters in the information entered by copy-paste.
Issue 2: Shipping Label Not Generated
Solution: At least one of the products in the order may be missing weight information. Fill in the weight information from Products → [relevant product] → Shipping tab. Also, verify that the customer number in the contract has been entered correctly in the API settings, paying attention to capitalization.
Issue 3: Tracking Number Not Sent to Customer
Solution: Go to Settings → Notifications → Shipping confirmation email template and check that the {{ fulfillment.tracking_number }} variable is present. This variable may have been deleted in customized email templates; compare it with the original Shopify template to fix the issue.
Issue 4: Incorrect Shipping Cost Calculation
Solution: There may be a region conflict in the Shipping zones section. If separate regions are defined for both 'Turkey' and 'Istanbul', Shopify may apply both rules. Prioritize the most specific region definition and clean up conflicting regions.
Frequently Asked Questions
How do I set up shipping integration in Shopify?
Shopify shipping integration is completed by signing a corporate agreement with the shipping company and obtaining API information, then downloading the relevant application from the Shopify App Store, entering this information, and defining shipping zones. The process takes 1-3 hours for official applications such as Yurtiçi and Aras Kargo, while integrations requiring middleware, such as MNG, can take 3-8 hours.
Which shipping companies does Shopify integrate with in Turkey?
Shopify can integrate with Yurtiçi Kargo, Aras Kargo, MNG Kargo, Sürat Kargo, and PTT Kargo in Turkey. Yurtiçi and Aras have official apps in the Shopify App Store. MNG and Sürat require a middleware solution such as Geliver. PTT Kargo can only be integrated with custom API development.
Which plan is required for Shopify shipping integration?
Basic shipping applications work with any paid Shopify plan (Basic, Shopify, Advanced).
Can multiple shipping companies be used in Shopify?
Yes. Different shipping carriers can be assigned to different delivery regions in Shopify.
What is the cost of Shopify shipping integration?
Official Shopify shipping apps (Yurtiçi, Aras) are free. Middleware platforms charge a monthly subscription fee of $20–80. Custom API development involves a one-time cost depending on the scope of the project. Shipping costs vary depending on the corporate contract signed with the shipping company and the monthly volume.
How is MNG Kargo Shopify integration set up?
Since MNG Kargo does not have an official Shopify app, the integration is set up through middleware platforms such as Geliver or Entegrasyonum.com. First, a corporate contract is signed with MNG and API information is obtained. Then, this information is entered into the middleware platform to establish the Shopify connection. Since MNG requires a minimum of 500 shipments per month, stores that do not meet this threshold are advised to choose Yurtiçi or Aras first.
How long does Shopify shipping integration take?
The Shopify shipping integration time varies depending on the method selected. Integrations set up through the official app (Yurtiçi, Aras) are completed within 1–3 hours; however, the API access agreement must be signed in advance. Integrations requiring middleware (MNG, Sürat) take 3–8 hours. Custom API development takes 2–5 business days. The corporate contract process requires an additional 3–10 business days for all methods.
Which shipping company is recommended for Shopify shipping integration?
General recommendation for Shopify stores in Turkey: For fewer than 200 orders per month, the free official app from Yurtiçi or Aras Kargo is sufficient. For 500+ orders per month and a wide regional coverage, Aras and Sürat offer negotiated price advantages. Yurtiçi's network of 780+ branches stands out for its access to small settlements in Anatolia.
Is it difficult to change the shipping company on Shopify?
Changing the shipping company on Shopify is technically simple: just remove the current app and install the new company's app. The challenging part is the operational transition: signing a contract with the new company, obtaining API information, and getting warehouse staff accustomed to the new labeling process usually requires a 1–2 week adjustment period.
Set Up Your Shopify Shipping Integration Correctly
When properly configured, Shopify shipping integration reduces the manual time spent per order from hours to minutes, increases customer satisfaction, and prevents costs arising from operational errors. Incorrect or incomplete setups, however, may seem problem-free at first glance but can cause critical issues during scaling.
As Nodus Works, Turkey's most experienced Shopify agency, we build shipping infrastructure from scratch for hundreds of stores. We manage domestic, Aras, MNG, and Sürat Kargo integrations both technically and operationally.
If you're transitioning platforms, check out our Shopify Migration service.
To set up your shipping integration with Nodus Works, contact us. The initial consultation is free; we prepare a customized integration plan for your store.
