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

Get in touch
WooCommerce

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.

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 · interface language: English
Licence
a site + a staging copy, annual
Trial
7 days, no card, one per site
Updated
12.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
NZBN field at the classic and block checkout (optional or required, your own label) ✔ ✔
13 digits and the check digit tested before the register is asked ✔ ✔
Lookup in the NZBN register while typing and when the order is placed; a number with a wrong format stops the order ✔ ✔
"Refuse unknown numbers" — off by default ✔ ✔
Business name from the register into an empty company field ✔ ✔
Number, name, status, type and address on the order, in the note and in the box on the order screen ✔ ✔
Field in My account, the number is saved on the customer ✔ ✔
Production / Sandbox switch, "Check connection", "Look up" ✔ ✔
Register down: the order goes through with a "not verified" note ✔ ✔
API key encrypted in the database, register answers kept for 6 hours ✔ ✔
Search by business name with a list of suggestions — ✔
Address autofill from the register into empty billing fields — ✔
Refusing closed businesses (removed, liquidation, receivership, administration) — ✔
Refuse the order when the register is unavailable — ✔
GST number from the register on the order — ✔
B2B customer role for verified, trading businesses — ✔
Scheduled re-check of customers' saved numbers, journal and e-mail — ✔
"Check all customers now" in batches — ✔
"Check again" on the order and check before shipping — ✔
Updates from catcode.com.ua — ✔

What it looks like

The NZBN field at the WooCommerce checkout
Checkout: the business name and status from the register under the field, name and address filled into the empty fields (Pro).
The NZBN in the buyer's account
My account → Account details: the NZBN field with its status; the next checkout starts with this number.
NZBN Lookup settings
WooCommerce → NZBN: API key, Production or Sandbox, the checkout field, unknown numbers, “Check connection” and “Look up”.

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

v1.0.0 Current 12.11.2026

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

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

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

  1. Install the plugin and activate it (WooCommerce must be active).
  2. At api.business.govt.nz subscribe to the NZBN API and take the key once the subscription is approved.
  3. In WooCommerce → NZBN paste the key, choose Production, press “Check connection” and save.
  4. Choose whether the number is required and what happens to numbers the register does not know.
  5. Open the checkout: the NZBN field is already there.
  6. 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

  1. Plugins → Add New → Upload Plugin: choose the zip and activate it.
  2. WooCommerce → NZBN: paste the subscription key, choose Production or Sandbox, press “Check connection”, save.
  3. Open the checkout: the NZBN field is there.
  4. 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.

@catcode_support Setup, compatibility, activation
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.

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