Short answer
A PTT Kargo Shopify integration automatically sends Shopify orders to PTT’s web services to create barcodes and labels, writes the tracking number to the Shopify fulfillment once the parcel has been accepted at a PTT branch, and notifies the customer. The connection is built with a ready-made app from the Shopify App Store, a shipping aggregator platform, or a custom middleware layer that connects directly to PTT’s web services.
What sets PTT apart from other carriers is a branch network that reaches rural areas and a cash on delivery model that works as a “payment-conditional shipment” (ödeme şartlı gönderi). With a ready-made app you can go live in 2–5 business days; a custom build with payment-conditional shipments and an ERP connection takes 3–5 weeks. In every case you first need a corporate contract with PTT and a customer number.
This guide was prepared from the field experience of the Byte Digital team, a Shopify Plus Partner that has served Shopify brands since 2020.
What does a PTT Kargo Shopify integration do?
The integration removes four manual tasks between an order and its shipment: opening a shipment record, printing a barcode, writing the tracking number to the order and checking delivery status. For the general setup, see our Shopify shipping integration guide; on the PTT side the flow looks like this:
Step | Direction | Shopify side | PTT side |
|---|---|---|---|
Shipment record | Shopify → PTT | Order, FulfillmentOrder (recipient address, items, weight) | Shipment record (before acceptance) |
Barcode and label | PTT → Shopify | App or middleware prints the label | Barcode from the range PTT assigns |
Tracking number | PTT → Shopify | Fulfillment, trackingInfo (company, number, url) | Queryable after physical acceptance at a branch |
Delivery status | PTT → Shopify | FulfillmentEvent (IN_TRANSIT, DELIVERED, etc.) | Shipment inquiry service |
COD amount | Shopify → PTT | Order total of the cash on delivery order | Payment-conditional shipment amount |
Returns | Both ways | Return record | Return barcode or return shipment |
PTT’s web services have long been SOAP (XML) based; creating a shipment, querying a shipment and deleting a record that has not been accepted are handled by separate methods. Access uses the customer number and password issued by PTT.
PTT-specific rules: what to watch for in the integration
What makes a PTT integration its own project is that the shipment record and physical acceptance are two separate stages. Automation on the Shopify side has to be designed around both.
Tracking data appears after acceptance: The barcode is generated on the order immediately, but until the parcel is physically accepted at a PTT branch or pickup point, the inquiry service returns no meaningful status. Sending the “shipped” notification after acceptance, not when the barcode is created, cuts complaints.
Barcode range: PTT assigns corporate customers a barcode range. The middleware generates the next barcode from this range; the counter must live in one place so the same barcode is never given to two orders.
Payment-conditional shipment (cash on delivery): At PTT, cash on delivery works by adding the amount to collect to the shipment record as “payment-conditional”. The amount should come from the Shopify order total and be updated if it changes after a partial refund or discount.
Volumetric weight and weight: Pricing is based on the greater of actual weight and volumetric weight (desi). If variant weights are empty in Shopify, the middleware sends a fixed default and the invoices come as a surprise.
Address structure: PTT works at province, district and neighbourhood level. District and neighbourhood data entered as free text at Shopify checkout must be mapped to PTT’s reference list; unmatched addresses get stuck at acceptance.
A carrier Shopify recognises: “PTT” is among the tracking companies Shopify supports for Turkey (Shopify FulfillmentTrackingInfo). Even so, sending the tracking URL explicitly is recommended.
PTT Kargo Shopify integration methods
A ready-made App Store app suits low volume and a standard flow, an aggregator platform suits brands working with several carriers, and a custom middleware layer suits setups with payment-conditional shipments and an ERP connection.
Method | When to choose it | Setup time | Flexibility | Ongoing cost |
|---|---|---|---|---|
Shopify app (PTT Kargo apps on the App Store) | One carrier, a few dozen orders a day | 2–5 business days | Low–medium | Monthly subscription |
Aggregator platform (e.g. Navlungo) | Using PTT alongside other carriers, one panel | 1–2 weeks | Medium | Per shipment or monthly |
Custom middleware (PTT web services) | ERP, warehouse software, payment-conditional shipment rules | 3–5 weeks | Highest | Hosting + maintenance |
The App Store has apps built for PTT Kargo that support barcodes, tracking numbers and payment-conditional shipments; all of them require a contract with PTT and a customer number. Aggregator platforms create PTT shipments under their own agreements or yours. Many brands do not use PTT alone: they ship with a carrier such as Aras Kargo in city centres and with PTT for rural deliveries. In that case a middleware layer that selects the carrier per order by rule gives a cleaner result than two separate apps.
PTT Kargo Shopify integration step by step: time and cost
It takes 2–5 business days with a ready-made app and 3–5 weeks with a custom build; most of the time goes to the PTT contract process and address mapping.
Contract and access (1–2 weeks): A corporate contract is signed with PTT, and a customer number, web service password and barcode range are obtained. If payment-conditional shipments will be used, they are added to the contract.
Shopify preparation (1–3 days): Variant weights are filled in, the shipping location (Location) is confirmed, and cash on delivery is set up as a manual payment method in Shopify.
Setup or development (1 day – 3 weeks): The app is installed or the middleware is built: reading FulfillmentOrders, creating shipments, barcodes, creating fulfillments and syncing status.
Testing (2–5 days): Low-value test shipments to real addresses, one payment-conditional shipment and one return scenario are tried.
Go-live and monitoring (1 week): In the first week, unaccepted shipments, address errors and notification timing are checked daily.
The main cost drivers: daily order volume, share of payment-conditional shipments, whether an ERP or warehouse software is part of the process, whether carriers are selected by rule, and whether the return flow is automated. Shipping rates depend on your agreement with PTT.
Cash on delivery and returns: how are they handled with PTT?
On a cash on delivery order, payment stays “pending” in Shopify; when PTT collects the payment and delivers, the order should be marked as paid. Doing this manually leaves a gap between accounting and Shopify.
In Byte Digital’s analysis of 100 Turkish Shopify stores, 31% of stores offered cash on delivery. The most common issue we see in these stores is delivered payment-conditional shipments showing as “payment pending” in Shopify for months. In the right setup, the middleware marks the order as paid when it receives the delivered status, and moves a returned (not collected) shipment into the cancel or refund flow. On the card side, getting your virtual POS setup right is the easiest way to lower the share of cash on delivery over time.
There are two ways to handle returns: generating a return barcode for the customer through PTT, or having the customer drop the parcel at a branch with a contracted return code. Whichever you choose, the tracking number of the return shipment should be linked to the return record in Shopify.
The 6 most common PTT Kargo Shopify integration mistakes
Most problems appear not when the integration is first set up but when order volume grows and during campaign periods.
Notifying the customer as soon as the barcode is created: The parcel has not been accepted at a branch yet, so the tracking page looks empty and support gets flooded with questions.
Sending a fixed COD amount: The amount changes after discounts, shipping fees or partial refunds; a wrong collection affects both the customer and accounting.
Going live without weights: If the default desi is lower than the real one, the PTT invoice comes in higher than expected.
Skipping address mapping: If district and neighbourhood are not mapped to the reference list, shipments wait at acceptance.
Not sending a tracking URL: Even with the correct carrier name, writing the URL explicitly guarantees the customer sees a working link on the order status page.
Treating order automation separately from shipping: If labelling, stock deduction and invoicing are not designed together, each stays a separate manual step. Design automated order processing and the shipping integration as one flow.
PTT Kargo Shopify integration with Byte Digital
Byte Digital is an Istanbul-based Shopify Plus Partner that has provided Shopify builds, integrations and Shopify technical support to leading Turkish brands since 2020. For brands using PTT on its own or alongside other carriers, we build payment-conditional shipments, returns and the ERP flow into one Shopify-centred structure.
Share your daily order volume, your cash on delivery share and the other carriers you use; we will prepare a free preliminary assessment with the right method, timeline and estimated budget.
Request a free PTT Kargo Shopify assessment →
Frequently asked questions
Can Shopify be integrated with PTT Kargo?
Yes. It can be integrated with PTT Kargo apps on the App Store, aggregator platforms that support PTT, or a custom middleware layer connected to PTT’s web services. Every method requires a corporate contract with PTT and a customer number.
How do you get access to the PTT Kargo API?
After signing a corporate customer contract with PTT, the customer number, web service password and barcode range are requested through PTT’s corporate account representative. Technical documentation is shared during this process.
Does PTT Kargo cash on delivery work with Shopify?
Yes. At PTT, cash on delivery is defined as a payment-conditional shipment; the amount is taken from the Shopify order and added to the shipment record. Marking the order as paid in Shopify after delivery can also be automated.
Why doesn’t the tracking number show up right away?
At PTT, the shipment record and barcode are created immediately, but the inquiry service returns a status only after the parcel is physically accepted at a branch. Timing notifications to acceptance solves this.
Can I use PTT together with another carrier?
Yes. A common setup is shipping with another carrier in major cities and with PTT to rural addresses. This requires an aggregator platform or a custom middleware layer that selects the carrier per order by rule.
How is volumetric weight calculated in Shopify?
Shopify stores only weight at variant level. For volumetric weight, product or package dimensions are kept in metafields, and the middleware calculates the desi from them and sends it to PTT.





