Torod – WooCommerce Shipping for Saudi Arabia & GCC

By Torod Company for Information Technology

★ 3.7/5 (3 ratings)50+ active installationsVersion 3.1.0

WooCommerce shipping for Saudi Arabia and the GCC: send orders to SMSA, Aramex, Naqel and 60+ couriers, print labels, track and collect COD.

Description

Torod is the WooCommerce shipping plugin for stores in Saudi Arabia (KSA) and the GCC. Connect your store once and ship with SMSA, Aramex, Naqel, SPL (Saudi Post), DHL, J&T, Redbox, iMile and more than 60 local and international couriers through a single Torod account. Orders are sent to Torod automatically, you print shipping labels (AWB) and choose the courier in the Torod portal, and tracking numbers and delivery statuses come back to every WooCommerce order.

Whether you ship a few orders a week or hundreds a day, from Riyadh, Jeddah, Dammam or anywhere in the Kingdom, Torod replaces copying orders into courier dashboards with one automatic, reliable shipping integration, including cash on delivery (COD).

Why stores use Torod

  • One account, many couriers. Compare and choose couriers in the Torod portal instead of managing a contract and a dashboard for each one.
  • No copy and paste. Orders are sent to Torod automatically, with the customer’s address, phone, items, weight and cash-on-delivery amount.
  • Customers and staff stay informed. Tracking numbers, labels and shipment statuses appear on every order in WooCommerce.

Automatic order sync

  • Automatic sending when an order reaches the statuses you choose (Processing by default), whether it comes from checkout, wp-admin or another app.
  • Fast and reliable. Orders are sent right after checkout without slowing it down, with three automatic retries if Torod cannot be reached.
  • Never sent twice. Each order goes to Torod once, under its WooCommerce order ID (the same as the order number unless another plugin renumbers orders), so you can find it in the Torod portal.
  • Cash on delivery. Choose which payment methods the courier collects; the order total (shipping, fees and discounts included, less any refunds) is sent.
  • Manual and bulk sending from the order screen or the WooCommerce orders list.
  • Failed orders. Any order that could not be sent is listed with the reason and can be retried in one click, or all at once.

Shipping labels, tracking and delivery status

  • Torod Shipment box on every order: Torod order number, tracking number, courier, latest status, label download and tracking link.
  • Status sync. Torod sends shipment updates to your store, and you decide which WooCommerce status each shipment status sets. By default, delivered shipments complete the order.

Shipment tracking for your customers

  • In My Account. A Shipment column in the orders list, and a shipment card on the order page with plain-language progress steps (Preparing, Ready to ship, On its way, Out for delivery, Delivered), the shipping company, the tracking number with a copy button, the latest update in the customer’s language, the shipment history and a Track shipment button.
  • On the thank-you and order tracking pages, and in customer emails once there is a tracking number.
  • You choose what customers see in Torod › Configurations › Customer view, with a live preview. Shipping labels are never shown to customers.
  • Works with any theme. Uses WooCommerce’s own hooks, inherits your theme’s fonts and colours, right-to-left aware, keyboard and screen-reader friendly. Templates can be overridden in your theme (yourtheme/torod/).

Saudi regions and cities at checkout

  • Torod regions and cities. Regions appear as the state field. On the classic checkout customers pick their city from a searchable list in Arabic or English; on the block checkout they type it. Both checkouts check that Torod delivers to the city before the order is placed.
  • Destinations. Choose the countries you ship to and switch off regions or cities you do not deliver to.

Built for Saudi and GCC stores

  • Fully in Arabic and English, in wp-admin and at checkout, with right-to-left layouts.
  • Quick setup. After you connect your account, Saudi regions and cities download in the background, with a progress bar. You can leave the page while it runs.
  • Live and demo environments, so you can test without creating real shipments.
  • Compatible with WooCommerce High-Performance Order Storage (HPOS) and the block checkout.

Support

Email support@torod.co or read the guides at help.torod.co.

External services

This plugin connects to Torod (https://torod.co), a Saudi shipping platform, to create shipments and receive their status. It only does so after you connect your Torod account.

  • Torod API — https://api.torod.co (Live) or https://demo.stage.torod.co (Demo, when you choose the demo environment). Every request identifies the store by its site address.
    • When you connect or create an account: your Torod email and password (or, to create an account, your name, store name, email and mobile number), plus the store name, site address and the webhook address below.
    • When an order is sent or updated: the order number, the customer’s name, phone, email and shipping address, the items with weights, the order total and the payment type (cash on delivery or prepaid).
    • Once a day and when you click Refresh data: the list of countries, regions and cities is downloaded (no customer data is sent).
  • Torod webhook — Torod sends shipment updates (status, courier, tracking number, label and tracking links) to your store at /Torod/shipment/webhook (or /?torod_webhook=1 with Plain permalinks). They are accepted only with your account’s secret.
  • Tracking pages — the Track shipment button and links in emails open Torod’s tracking page on torod.co for that shipment.

Torod’s terms and conditions and privacy policy.

Privacy

Customer details leave your store only as listed above, to create and track the shipment. Logs are stored in the private WooCommerce log; names, addresses, phone numbers and email addresses in them are masked. WooCommerce’s personal data export and erase tools include the shipment details. Connecting or changing the Torod account is limited to administrators; the other settings and actions to store managers.

Installation

  1. Install and activate WooCommerce.
  2. Install Torod from Plugins › Add New (or upload the zip) and activate it.
  3. Open Torod › Configurations › Account and connect with your Torod email and password, or create a Torod account there.
  4. Wait for the banner to say Delivery locations are ready. Regions and cities download in the background; you can leave the page meanwhile.
  5. In Sync preferences, choose the order statuses that send orders and your cash-on-delivery payment methods.
  6. Optional: in Order statuses, choose what each shipment status does to the WooCommerce order, and in Destinations, switch off places you do not deliver to.

FAQ

Do I need a Torod account?

Yes. You can create one from Torod › Configurations › Account, or at torod.co.

Which shipping companies can I use?

More than 60 local and international couriers available in your Torod account, including SMSA, Aramex, Naqel, SPL (Saudi Post), DHL, J&T, Redbox and iMile. You choose the courier for each shipment in the Torod portal.

Can I print shipping labels (AWB) from WooCommerce?

Yes. Once the shipment is created in Torod, the Torod Shipment box on the order has a Download label button, and the tracking number and tracking link appear next to it.

Does it support cash on delivery (COD)?

Yes. Choose which payment methods count as cash on delivery; the courier collects the order total, including shipping, fees and discounts. Items and amounts refunded before the order is sent are left out.

Does it work outside Saudi Arabia?

Torod is built for Saudi Arabia and also serves other GCC countries. In Destinations, choose the countries you ship to; their regions and cities are downloaded from Torod.

When is an order sent to Torod?

When it reaches one of the statuses selected in Sync preferences (Processing by default). You can also send any order from its order screen, or several at once from the orders list.

An order was not sent. What do I do?

Open Torod › Failed orders. Each order shows the reason, for example a city that is not in Torod’s list or a phone number Torod does not accept. Fix the order and click Retry sending. Temporary errors are retried automatically three times.

Which order number does Torod show?

The WooCommerce order ID, so you can search for it in the Torod portal. It is the same as the order number unless a plugin renumbers your orders (sequential order numbers); then search by the ID shown in the order’s address bar in wp-admin.

Is the plugin available in Arabic?

Yes. wp-admin and the checkout follow the site and user language, and Torod’s region and city names are shown in Arabic or English.

Does it work with the block checkout?

Yes. Regions appear as states in both checkouts. The searchable city list is available in the classic checkout; in the block checkout the city is typed and checked against Torod’s city list when the order is placed (WooCommerce 9.0 or later).

Do Torod regions change my shipping zones or tax rates?

Torod regions replace the state list of each country you ship to with Torod, so a region is saved on orders as Torod’s region ID. Shipping zones or tax rates that are limited to a state of one of those countries must be set again with the Torod regions (WooCommerce › Settings › Shipping or Tax lists them). Zones and rates for a whole country or a postcode are not affected.

I am upgrading from version 2.x. Do I need to reconnect?

No. Your connection, sync statuses, cash-on-delivery methods and status mapping are moved over automatically, and shipments created by 2.x keep receiving updates. Delivery locations download again in the background.

Can I send an order again after it was cancelled in Torod?

Each order is sent to Torod once, with its order number. To ship it again, create the shipment in the Torod portal.

Can a staging copy of my store use the same Torod account?

Connect staging copies to the Torod demo environment (Torod › Advanced › Environment). A copy connected to the live account shares order numbers with your store, and Torod accepts each order number only once per account.

Where can I get help?

Email support@torod.co.

Screenshots

Changelog

3.1.0

  • New: shipment tracking for customers. A Shipment column in My Account › Orders, a shipment card on the order, thank-you and order tracking pages (progress steps, shipping company, tracking number with copy button, latest update in Arabic or English, shipment history, Track shipment button) and a shipment summary in customer emails.
  • New: Torod › Configurations › Customer view, with switches for each detail and a live preview. Tracking is shown to customers as soon as you update; switch it off there if you prefer.
  • New: both checkouts check that Torod delivers to the customer’s city before the order is placed, so orders no longer fail later with “city not found”. Common spelling differences are accepted (Al Khobar / Khobar, جده / جدة), only once a region’s cities are fully downloaded; a city matched from a different spelling is noted on the order.
  • New: local pickup orders and orders with only virtual items are no longer sent to Torod automatically (filter torod_should_send_order).
  • New: suggested privacy policy text (Settings › Privacy).
  • Improved: shipment updates for the same order are applied one at a time, late or repeated updates never move a status back, and Torod’s dates are read as Saudi time.
  • Fixed: on stores using WooCommerce’s order tables (HPOS), orders shipped with plugin 2.x showed as not sent (with “Send to Torod” offered again) because 2.x kept their Torod ID in the old posts table. The ID is now copied over on update.
  • Fixed: after a plugin update, other plugins’ links could return “page not found” until permalinks were saved again.
  • Fixed: the webhook address now also works with Plain permalinks.
  • Fixed: stores that switch off more than about 1,000 cities in Destinations no longer get some switched back on.
  • Fixed: “Refresh data” no longer times out on large regions.
  • Fixed: the city field is no longer emptied when the order is placed while the city list is loading.
  • Improved: the city chosen at checkout is saved as a name straight away, so other plugins see the city name instead of a Torod ID.
  • Improved: the city list loads only on the classic checkout and address pages, and keeps working on cached pages.
  • Improved: the mandatory-update notice can be dismissed and no longer appears on the orders screens.
  • Improved: Send and Retry buttons only appear for users who are allowed to use them.
  • Improved: Arabic sites show every new text in Arabic straight away (the bundled translation fills what the wordpress.org language pack does not have yet); order notes use the store’s language; dates follow the Arabic format; courier names are translated.
  • Improved: the shipment card sits above the order items and shows a vertical timeline with “Step 2 of 5” on phones; Torod’s wording is not repeated under the status.
  • Improved: admin screens: clearer menu names (Failed orders, Advanced), a “Customer sees” column in the status mapping (now also Ready for pickup and Out for delivery), Torod’s validation errors as plain sentences, readable status labels, and accessibility fixes (contrast, keyboard focus, field errors, high-contrast mode).
  • Improved: the checkout city check also works on stores without WooCommerce shipping methods, and a city edited after checkout is looked up again before sending.
  • Improved: orders cancelled or refunded while waiting are never sent, and an order put on hold after it was queued is not sent automatically; orders that were waiting when the plugin was deactivated are sent after it is reactivated; Torod updates that arrive together are applied one after the other.
  • Improved: items and amounts refunded before an order is sent are left out of the shipment and the cash-on-delivery amount.
  • Improved: a send interrupted while waiting for Torod’s answer is recognised and linked on the next attempt; a region Torod has no cities for no longer holds up setup.
  • Improved: the order screen says why an order cannot be sent (and links to Sync preferences for completed orders).
  • Improved: if Torod is briefly unreachable while the access token renews, orders and location downloads are retried instead of failing; a send interrupted by disconnecting or switching environment is never retried into the account connected afterwards; “Retry sending all” also works when automatic sending is off (orders put on hold are left for their own Retry sending button).
  • Security: label and tracking links only to torod.co; only administrators can connect, disconnect or switch the Torod account; invisible formatting characters are removed from Torod’s text; debug logs mask personal details; WooCommerce’s personal data export and erase include the shipment details.
  • Changed: requires WordPress 6.5 and WooCommerce 9.0 or later.

3.0.1

  • Fixed: after updating from 2.x, the Orders log listed old orders that 2.x had skipped on purpose (for example “order status not selected”) and orders that were already completed or cancelled. Retrying them would have sent old orders to Torod. These entries are removed automatically when you update; real failures on open orders stay listed.

3.0.0

A rebuilt Torod plugin: faster, more reliable and fully in Arabic. This update is mandatory.

Highlights

  • Orders are sent right after checkout, in the background, with automatic retries; checkout is never slowed down.
  • New Torod Shipment box on every order: tracking number, courier, status, label download and tracking link.
  • Searchable Arabic and English city list at checkout, matched to Torod’s delivery areas.
  • Delivery locations download in the background after connecting, with a progress bar.
  • Redesigned admin, fully in Arabic and English.

New

  • Several trigger statuses and several cash-on-delivery payment methods.
  • Failed orders with retry and retry all, and bulk “Send to Torod” in the orders list.
  • Dashboard with sent and failed order counts.
  • Live and demo environments, with confirmation before switching.
  • Optional sending of order changes to Torod when an order is saved.
  • Status mapping with defaults (delivered shipments complete the order) and “Restore defaults”.
  • Notice to administrators when a mandatory Torod update is available.
  • Compatibility with HPOS and the block checkout.

Improved

  • Each order is sent once, with its exact WooCommerce order number; an order Torod already received (for example after a timeout) is linked, never duplicated.
  • Each region and city keeps its own on/off setting.
  • Location data refreshes daily and resumes where it stopped after an interruption.
  • Messages from other plugins no longer clutter the Torod pages.

Fixed

  • The cash-on-delivery amount now includes shipping, fees and discounts.
  • The shipping address is used when it differs from the billing address.
  • Product weights are converted to kilograms and multiplied by quantity.

Security

  • All admin actions require store-manager rights and a security token; nothing is reachable by visitors except the city list at checkout.
  • Database queries are prepared and output is escaped.
  • Webhooks are verified with the store secret (optionally an HMAC signature), compared in constant time.
  • Logs moved to the private WooCommerce log, without customer details.
  • Old 2.x settings, including the stored API secret, are removed after migration.

Removed

  • The Guzzle library and bundled place lists for countries Torod does not serve.

2.1.1

  • Last 2.x release.