Black November: −35% on all modules until 30 November Black November: −35% until 30 November Choose a module

Get in touch
WooCommerce

Shipping with GHN for WooCommerce — fee, shipments and tracking (Vietnam)

GHN (Giao Hàng Nhanh) in WooCommerce: the fee at the checkout, a shipment from the order, tracking; Pro adds bulk shipments, labels, a webhook and a cash on delivery report.

Download Free
Pro · one-year licence Staging copies are included. The more sites, the cheaper each one
Compatibility
WordPress 6.4+ · WooCommerce 8.6+ · PHP 7.4+ · HPOS, block checkout · a GHN account, API token and ShopId required · interface language: English (Pro also tiếng Việt)
Licence
a site + a staging copy, annual
Trial
7 days, no card, one per site
Updated
15.11.2026
Or all 509 Pro modules with All Access — 3 244 UAH / year ≈ €66

What Free has,
and what Pro adds

The free version works with no time limit. Pro adds the rest of the features in the table.

Feature Free Pro
The GHN fee at the checkout: the new address (province and ward), weight, size and declared value, exchange rate to VND ✔ ✔
The “GHN” method in shipping zones, name at the checkout, tax status ✔ ✔
Classic and block checkout, HPOS ✔ ✔
Vietnamese address fields: 34 provinces, the ward list from GHN ✔ ✔
A shipment from one order with a button, cash on delivery for the payment methods you choose ✔ ✔
“Update status” and “Cancel shipment” before the pickup ✔ ✔
The tracking code and status on the order page and in e-mails ✔ ✔
Settings: API token encrypted, production and staging, ShopId, “Check connection”, “Test the fee” ✔ ✔
Automatic shipment on an order status — ✔
Bulk creation (15 per run) and label printing (up to 100) — ✔
Label printing from the order: A5, 80 × 80, 52 × 70 — ✔
Status by webhook, the cash on delivery transfer date, order status change after delivery or return — ✔
Hourly check of open shipments — ✔
Price rules: free shipping from an amount, markup, rounding — ✔
Several GHN shops: a ShopId per order — ✔
Cash on delivery report with CSV export — ✔
Vietnamese interface — ✔
Updates from catcode.com.ua — ✔

What it looks like

Vietnamese address at the checkout
Address fields: country Vietnam, a province from the list, “Phường / xã” with the ward list from GHN, street and postcode.
The GHN fee for the buyer
The shipping method “GHN — Giao Hàng Nhanh” next to store pickup, the fee in dong.
Tracking for the buyer
Order page: the heading “Giao hàng bởi GHN”, the tracking code and the current status of the parcel.

Key points

What the buyer gets

At the checkout the buyer picks the province and the ward from the list GHN provides: since 1 July 2025 Vietnam uses a 2-level address with no district, and the plugin sends GHN its own names of the province and the ward.

What the admin gets

WooCommerce → GHN: the API token (stored encrypted), the ShopId, the environment (GHN production or staging), a sender address (optional), the weight and size of products without them, an exchange rate to VND for shops in another currency, insurance (declared value, up to 5,000,000), the delivery instruction (look but not try, try, do not open), who pays GHN (the shop or the receiver) and the payment methods for which GHN collects cash on delivery. “Check connection” lists the shops of your GHN account and verifies the ShopId, “Test the fee” gives the fee for any address and weight.

How much it costs

The basic version is free. Pro costs 1290 UAH for a one-year licence. A year of updates, technical support and all Pro features.

The trial starts when you ask

A fresh install is the free version, nothing switches on by itself. The “Try Pro for 7 days” button → e-mail → the key right in the window and by e-mail.

One key — a site and a staging copy

Moving the site? Unlink the licence on the old domain and activate it on the new one yourself. A staging copy (staging., dev.) works with the same key and does not take a site slot. For studios — keys for 5 or 25 sites, or unlimited.

Technical requirements

  • WordPress 6.4+, WooCommerce 8.6+ (HPOS and the block checkout are supported), PHP 7.4+.
  • A GHN account, an API token and a ShopId.
  • Interface language: English; Vietnamese is included in the Pro build.

Version history

v1.0.0 Current 15.11.2026

The GHN fee at the classic and the block checkout on the new 2-level address, Vietnamese address fields with the ward list from GHN, a shipment from the order with cash on delivery, status…

Frequently bought with Shipping with GHN

All Access Need more? All modules (509) under one licence, new ones are added automatically. 3 244 UAH≈ €66 Learn more →

Full module description

Shipping with GHN for WooCommerce connects your shop to the Giao Hàng Nhanh (GHN) delivery service in Vietnam. At the checkout the buyer picks the province and the ward and sees the GHN fee; in the order one button creates a shipment with the products, weight, size, cash on delivery and the buyer’s details, and the tracking code and status are shown to the buyer.

What you need. Your own GHN account, an API token (GHN Developer Portal → account menu → Manage token) and the ShopId of your shop. Paste the token in WooCommerce → GHN, press “Check connection”, enter the ShopId and add the “GHN” method to the Vietnam shipping zone. GHN bills the deliveries to your account.

What the buyer gets

At the checkout the buyer picks the province and the ward from the list GHN provides: since 1 July 2025 Vietnam uses a 2-level address with no district, and the plugin sends GHN its own names of the province and the ward. On the classic checkout and in My account the ward field is GHN’s list; on the block checkout the plugin matches the typed ward to GHN’s list with or without accents and with or without the “Phường / Xã” prefix.

Right after the address is chosen the buyer sees the GHN fee for the cart and, if you want, the delivery date. Where GHN does not deliver or returns no price, the method is not offered: the buyer never sees a false zero.

After the order the buyer sees the tracking code and the GHN status on the order page and in the order e-mails.

What the admin gets

WooCommerce → GHN: the API token (stored encrypted), the ShopId, the environment (GHN production or staging), a sender address (optional), the weight and size of products without them, an exchange rate to VND for shops in another currency, insurance (declared value, up to 5,000,000), the delivery instruction (look but not try, try, do not open), who pays GHN (the shop or the receiver) and the payment methods for which GHN collects cash on delivery. “Check connection” lists the shops of your GHN account and verifies the ShopId, “Test the fee” gives the fee for any address and weight.

In WooCommerce → Settings → Shipping add the “GHN — Giao Hàng Nhanh” method to a zone: the name for the buyer and the tax status. A tick in the GHN settings shows the delivery date next to the price. A “GHN” box appears in the order.

“Create GHN shipment” sends GHN the products with price, weight, size and quantity, the declared value, the buyer’s name, phone, address and note; for cash on delivery orders GHN collects the order total. A repeated click or a lost answer never makes a second shipment. The box then shows the tracking code, the status, the GHN fee, the cash on delivery and the expected delivery date. “Update status” reads the status from GHN, “Cancel shipment” cancels it before the pickup, and you can create a new one.

What Pro adds

  • Automatic on a status. A shipment is created by itself when the order reaches the status you choose.
  • In bulk. “Create GHN shipments” from the order list (up to 15 per run) and “Print GHN labels” for several orders (up to 100 labels).
  • Label. Print the GHN label from the order: A5, 80 × 80 mm or 52 × 70 mm.
  • Status by webhook. GHN tells the shop about every status change, the cash on delivery amount, the fee and the date the cash on delivery is transferred; the order can move to the status you choose when the parcel is delivered or returned. A status never moves back and repeated events are ignored. The webhook address is protected by a secret.
  • Hourly check of open shipments (20 per run) in case a webhook did not arrive.
  • Price rules. Free shipping from a cart amount, a fixed or percentage markup on the GHN fee, rounding.
  • Several GHN shops. The ShopId is chosen in the order from the shops of your account.
  • Cash on delivery report. Shipments with status, fee, collected cash and the date it is transferred, with CSV export.
  • Vietnamese interface and updates from catcode.com.ua.

Limits

  • You need your own GHN account, an API token and a ShopId; GHN bills the deliveries to your account.
  • For the fee the buyer has to choose a province and a ward GHN knows. The method is not offered when GHN does not know the ward, does not deliver to that address, returns no price or does not answer, and for parcels over 50 kg or 200 cm on a side.
  • GHN needs a receiver name and phone to price a parcel, which the buyer may not have typed yet at the checkout, so the fee request carries your shop’s name and phone. The buyer is sent to GHN only when the shipment is created.
  • The fee at the checkout is GHN’s answer at that moment; GHN prices the shipment again when it is created and adds the cash on delivery fee only then, so the amounts can differ.
  • GHN prices in dong. For a shop in another currency set the exchange rate to VND: without it the method is not offered at the checkout.
  • The GHN ward list as a drop-down is on the classic checkout and in My account; on the block checkout the ward is typed, and a ward name used before 2025 gives no fee.
  • A shipment can be cancelled until it is picked up. The webhook address from the settings has to be given to GHN.
  • Bulk creation handles up to 15 orders per run.
  • The province list is added only when another plugin does not provide the Vietnamese states; the address fields can be turned off in the settings.

How it works, step by step

  1. Install the plugin and activate it (WooCommerce must be active).
  2. In WooCommerce → GHN paste the API token, press “Check connection”, enter the ShopId and save.
  3. In WooCommerce → Settings → Shipping add the “GHN” method to the Vietnam zone.
  4. The buyer picks the province and the ward and sees the fee at the checkout.
  5. In the order press “Create GHN shipment”.
  6. The tracking code and status appear in the order and for the buyer; “Update status” refreshes them, and in Pro the statuses arrive by themselves.

Under the hood

  • The GHN public API (online-gateway.ghn.vn): province and ward lists, fee calculation, shipment creation, status, cancellation, label printing and webhook.
  • All calls come from your server; the token is stored encrypted and never reaches the buyer’s browser.
  • Only the data needed for the fee and the shipment goes to GHN: the buyer’s province, ward and street, the products with weight, size and price, the declared value, the buyer’s name, phone and note, the cash on delivery amount, and your sender address if you set one.
  • Nothing is sent before you enter the token and the ShopId.

How to install

  1. Plugins → Add New → Upload Plugin: choose the zip and activate.
  2. WooCommerce → GHN: paste the token, press “Check connection”, enter the ShopId, save.
  3. Add the “GHN” method to the Vietnam shipping zone.
  4. For Pro: paste the licence key or start the trial in the “Licence” section on the same page.

Questions
about the module

Didn't find the answer? Message us on Telegram and we'll reply within a business day.

@catcode_support Setup, compatibility, activation
Is this an official GHN plugin?

No, it is an independent integration by CatCode. The names GHN and Giao Hàng Nhanh belong to their owner; the plugin is not affiliated with GHN and not endorsed by it.

Do I need a GHN account?

Yes. The plugin works with your own account, API token and ShopId; GHN bills the deliveries.

Why is GHN not offered at the checkout?

The buyer has to choose a province and a ward GHN knows. The method is hidden when GHN does not deliver to that address, returns no price or does not answer, the parcel is over 50 kg or 200 cm, or the shop sells in another currency without an exchange rate to VND. The last problem of a fee request is shown at the top of the plugin settings.

What about districts?

Vietnam abolished districts on 1 July 2025. The plugin sends GHN the new 2-level address: the province and the ward with GHN’s own names.

Why does the fee request carry my shop’s name and phone?

GHN prices a parcel with the same fields as a real shipment, which include a receiver name and phone. At the checkout the buyer may not have typed them yet, so your shop’s details stand in. Nothing is created at GHN; the buyer’s details are sent when you create the shipment.

Is the fee at the checkout the fee GHN charges?

The checkout shows the fee GHN returned for that address and parcel at that moment. GHN prices the shipment again when it is created and adds the cash on delivery fee only then, so the amounts can differ.

Can I cancel a shipment?

Yes, “Cancel shipment” cancels it before the pickup, and you can create a new one.

What happens after the trial?

Pro switches off and the free part keeps working: the fee at the checkout, creating a shipment from the order, the status and the tracking code.

How many sites does one key cover?

One key works on two sites: the shop and its development copy.

Not quite what you are looking for?

We build custom modules for WordPress, WooCommerce, OpenCart and Shopify. Tell us about the task and we'll prepare an estimate.

Order a custom module