
NZBN Lookup for WooCommerce — check a New Zealand Business Number at the checkout
Check a New Zealand business by NZBN at the WooCommerce checkout: name and status from the MBIE register, data on the order; Pro adds search by name, address autofill, a B2B role and refusing closed businesses.
- Compatibility
- WordPress 6.4+ · WooCommerce 8.6+ · PHP 7.4+ · HPOS · interface language: English
- Licence
- a site + a staging copy, annual
- Trial
- 7 days, no card, one per site
- Updated
- 12.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
The checkout gets an NZBN field (the label can be changed).
What the admin gets
WooCommerce → NZBN: paste the subscription key, choose Production (the live register) or Sandbox (MBIE test data, only with the Sandbox key), press “Check connection”, and say whether the number is required.
What Pro adds
Search by name. The buyer types a business name, picks it from a list, and the NZBN fills itself in.

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+, PHP 7.4+.
You need your own NZBN API subscription key from api.business.govt.nz (Production or Sandbox).
Compatible with HPOS, the classic and the block checkout. Interface language: English.
Version history
The NZBN field at the classic and block checkout and in the account, the check digit test, a lookup in the NZBN register (Production or Sandbox), the business name on the order, a note and…
Frequently bought with NZBN Lookup


Mainfreight Shipping for WooCommerce — Mainfreight rates and tracking (New Zealand)

Abandoned Cart Recovery for WooCommerce

Product bundles and gift with purchase for WooCommerce
Full module description
NZBN Lookup for WooCommerce adds an NZBN field to the checkout and to My account and checks the typed number against the New Zealand Business Number register through the free NZBN API of the Ministry of Business, Innovation and Employment (MBIE). An NZBN has 13 digits and the last one is a check digit, so a typo is caught at once, before the register is asked. The shop sees the business name and status, and the order keeps them. You need your own subscription key from api.business.govt.nz.
What you need. Every shop uses its own NZBN API key: register at api.business.govt.nz, subscribe to the NZBN API (the portal says there is no fee) and wait for the subscription to be approved by the MBIE API team, which approves subscriptions by hand and may ask what you need it for. The key goes into the plugin settings. The check confirms that a business with this number is in the register and what its status is; it does not check the GST number.
What the buyer gets
The checkout gets an NZBN field (the label can be changed). When the buyer leaves the field, the business name and status appear under it (“Example Trading Limited — Registered”), or a message says that the number is not in the register. A wrong check digit or length is caught without any request to the register. If the company field is empty, the name from the register goes there. Private buyers can skip the field: it is optional, and it is worth making it required only for a wholesale-only shop.
My account → Account details has the same field. The number the buyer typed at the checkout or here is kept on the customer, and the next checkout starts with it. The field at the block checkout and in Account details is one and the same value.
A number with a wrong format stops the order with a plain message. A number the register does not know does not stop the order by default: it only leaves a note on it. The “Refuse unknown numbers” option is off by default and can be turned on in the settings. If the register is down for a while, the order goes through and the note says that the number was not verified, so a government service never blocks sales.
What the admin gets
WooCommerce → NZBN: paste the subscription key, choose Production (the live register) or Sandbox (MBIE test data, only with the Sandbox key), press “Check connection”, and say whether the number is required. The key is stored encrypted and never reaches the browser. The “Look up” button checks any number right in the settings. Register answers are kept for 6 hours, and the requests come from your server, not from the buyer’s browser.
The order gets a box: number, name, status, type, address, registration date and the register number. The same goes into the order note. In Pro the box has a “Check again” button and the GST number the business published in the register.
What Pro adds
Search by name. The buyer types a business name, picks it from a list, and the NZBN fills itself in.
Address autofill. The business name and its address from the register (invoice, postal or registered) go into empty billing fields when the buyer enters the number. Works at the classic and the block checkout. The register gives no region, so the buyer fills that field in.
Closed businesses. A business the register shows as removed, closed, in liquidation, receivership or administration cannot place an order; the buyer sees the reason.
Register unavailable. If you wish, the order is refused when the register cannot be reached (by default it goes through with a note).
GST number on the order. The GST number the business published in the register is kept with the order. The plugin does not check whether the GST registration is valid and only shows what the register holds.
B2B customer role. A customer with a verified, trading business gets the role you picked (the one your trade-price plugin gives wholesale prices to); the role is taken back when the business closes. Shop managers and administrators are never touched, and the role is taken only from customers who got it from this plugin.
Customers re-checked on a schedule. The numbers saved on customer accounts are asked again every few days, in batches of 25 an hour (an unchanged record costs the register almost nothing: ETag is used). Name and status changes go to a journal and to the shop e-mail. The “Check all customers now” button runs the same check over all customers in batches.
Check again and check before shipping. The button on the order asks the register again and writes the change to the notes; if you wish, the register is asked once more when the order goes to Processing, and if the business no longer trades, the order is put on hold.
Updates from catcode.com.ua.
How it works, step by step
- Install the plugin and activate it (WooCommerce must be active).
- At api.business.govt.nz subscribe to the NZBN API and take the key once the subscription is approved.
- In WooCommerce → NZBN paste the key, choose Production, press “Check connection” and save.
- Choose whether the number is required and what happens to numbers the register does not know.
- Open the checkout: the NZBN field is already there.
- In Pro turn on search by name, address autofill, refusing closed businesses, the B2B role and scheduled customer re-checks.
Under the hood
- Data of the New Zealand Business Number register run by MBIE (the New Zealand government): a request by NZBN through the NZBN API, Production or Sandbox.
- Requests come from your server; the register receives the NZBN (in Pro, with search, the typed business name), not the buyer’s personal data. The subscription key travels in the Ocp-Apim-Subscription-Key header.
- Answers are kept for 6 hours, so the checkout does not load the register or spend the quota of your subscription.
- The NZBN API key is encrypted in the database and never printed to the browser.
- The block checkout field, the classic checkout field, Account details and the order work with one and the same saved value.
How to install
- Plugins → Add New → Upload Plugin: choose the zip and activate it.
- WooCommerce → NZBN: paste the subscription key, choose Production or Sandbox, press “Check connection”, save.
- Open the checkout: the NZBN field is there.
- For Pro: enter a 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 plugin of the NZBN or MBIE?
No, it is an independent integration by CatCode. The register data belongs to MBIE (the Ministry of Business, Innovation and Employment, the New Zealand government); the module is not affiliated with them and not endorsed by them.
Do I need a key or an account?
Yes. The NZBN API subscription at api.business.govt.nz is free, but the key is yours, not ours. The MBIE API team approves the subscription by hand and may ask what it is for.
What does "Refuse unknown numbers" do?
It is off by default. Then a number the register does not know does not stop the order: it only leaves a note on it. Turn it on if you want such numbers refused.
Does the plugin check the GST number?
No. It checks that a business with this NZBN is in the register and what its status is. Pro keeps the GST number the business itself published in the register.
Can private buyers still order?
Yes. Leave "Required" off and the field is optional.
What if the register is down?
The order goes through, and a note says the number was not verified. In Pro you can choose the opposite and refuse the order.
Why is a real number "not found" in the Sandbox?
The MBIE Sandbox holds test records and old Companies Register data, not the live register. For real numbers switch to Production with the Production key.
What happens after the trial?
Pro switches off and the free part keeps working: the field, the register check, the data on the order, the field in the account.
How many sites does a key cover?
One Pro licence key works on two sites: the shop and its test 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.




















