
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.
- 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
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.
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
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


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

Abandoned Cart Recovery for WooCommerce

Product bundles and gift with purchase for WooCommerce
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
- Install the plugin and activate it (WooCommerce must be active).
- In WooCommerce → GHN paste the API token, press “Check connection”, enter the ShopId and save.
- In WooCommerce → Settings → Shipping add the “GHN” method to the Vietnam zone.
- The buyer picks the province and the ward and sees the fee at the checkout.
- In the order press “Create GHN shipment”.
- 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
- Plugins → Add New → Upload Plugin: choose the zip and activate.
- WooCommerce → GHN: paste the token, press “Check connection”, enter the ShopId, save.
- Add the “GHN” method to the Vietnam shipping zone.
- 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.
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.
No reviews yet. Be the first.
No questions yet. Ask one — we answer within 24 hours.
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
Buying the module
—
Charged in UAH; your bank converts it to your currency. EUR price is approximate.




















