[Solved] Nuki Smart Lock Ultra + Homey Pro (Early 2023) – Matter incorrect_state (0x0003)

Devices
1

After spending several hours troubleshooting this issue, I finally found a workaround that solved it completely. Hopefully this will save other users some time.

Setup

  • Homey Pro (Early 2023)

  • Homey Pro v13.3.0

  • Nuki Smart Lock Ultra

  • Nuki firmware 5.7.11

  • iPhone (iOS)

  • Apple TV 4K (used only for testing)

Problem

I was unable to pair my Nuki Smart Lock Ultra with Homey using Matter.

After enabling Matter in the Nuki app:

  1. Homey successfully detected the lock.

  2. The Matter QR code was accepted.

  3. Homey displayed “Searching for device…”

  4. Pairing always failed with the following error:

Connection failed

Unable to pair device:

incorrect_state (0x0003)

What I tried (without success)

I tried all of the following:

  • Restarted Homey Pro

  • Restarted the Nuki lock

  • Updated Homey to the latest version

  • Updated the Nuki firmware to the latest version

  • Added the device using both the Matter driver and the Nuki driver

  • Scanned the Matter QR code

  • Entered the Matter pairing code manually

  • Moved Homey to within 50 cm (20 inches) of the lock

  • Kept the iPhone close to the lock

  • Verified that Thread was enabled and working on Homey

None of these steps solved the problem.

The workaround

I then decided to try pairing the lock with Apple Home.

Step 1

Add the lock to Apple Home using the Matter QR code.

:right_arrow: The pairing completed immediately without any issues.

Step 2

Without removing it from Apple Home, go back to Homey and add the lock via Matter.

:right_arrow: This time Homey paired with the lock successfully.

Step 3

After confirming that the lock was working correctly in Homey, I removed it from Apple Home.

Result:

:white_check_mark: The lock continues to work perfectly in Homey over Matter/Thread.

Verification

In Homey’s Advanced Device Settings, the device now reports:

  • Network Type: Thread

  • Vendor: Nuki

  • Product: Smart Lock Ultra

  • Matter Specification: 1.4.1

So the communication is indeed Matter over Thread, not cloud-based.

Conclusion

It appears that the issue only affects the initial Matter commissioning between Homey and the Nuki Smart Lock Ultra.

Once the lock has been commissioned by another Matter controller (Apple Home in my case), Homey can successfully join as a Matter administrator. After that, Apple Home can even be removed and Homey continues to control the lock normally.

I don’t know whether this is a Homey bug, a Nuki bug, or an interoperability issue between the two, but this workaround solved the problem completely for me.

Versions used

  • Homey Pro (Early 2023)

  • Homey Pro v13.3.0

  • Nuki Smart Lock Ultra

  • Firmware 5.7.11

  • Matter 1.4.1

I hope this helps anyone experiencing the same incorrect_state (0x0003) error.

If anyone else can reproduce this behavior or confirm the workaround, it would be interesting to know whether this is a general interoperability issue between Homey and the latest Nuki Smart Lock Ultra during the initial Matter commissioning process.

2

Does it also still work if you power down your Apple TV?

3

Important update

Unfortunately, the answer is yes.

The lock was removed from Apple Home, but I left the Apple TV powered on.

Everything continued to work correctly in Homey.

I then unplugged the Apple TV.

Result:

  • Homey immediately lost communication with the lock.
  • The Nuki app continued to operate the lock normally, even remotely and with Bluetooth disabled.

This means the lock itself remains online and connected.
Only Homey loses communication.

It therefore seems that Homey still depends on the Thread infrastructure provided by the Apple TV, even after successfully joining the lock via Matter.

This may indicate a Thread Border Router or Thread network migration issue rather than a pure Matter commissioning problem.

4

I had the same issue. I don’t think you need to add it to Apple home. I wasn’t able to pair directly to Homey, so i did get a message pair it via Iphone. That worked immediately.

Besides that: i love that lock!

5

Does anyone with only a Homey Pro (no Apple TV, no HomePod, no Google Nest Hub) have a Nuki Ultra working directly over Matter/Thread?

7

Probably not. I’ve read several posts about the Matter-over-Thread pairing impossibility of that particular lock & Homey Pro
You’d contact homey.app/support to have Athom fix this Matter-over-Thread bug

I noticed there’s “solutions” posted to add it as smart lock instead, but this d-tour uses a cloud connection (imho not a good plan when it comes to locks).

Not 100% relevant, but I’ve a Nuki 4 lock paired with OpenThread & Matter @ Home Assistant. Works fine (with the occasional hickup :face_with_peeking_eye:)

8

Further testing results

I did some additional testing with a second Nuki Smart Lock Ultra that had never been paired before.

Instead of pairing it through Apple Home, I selected “Pair via iPhone” from Homey. The first attempt failed, but the second one completed successfully.

Since then:

  • the lock has never appeared in Apple Home;
  • my Apple TV has remained powered off;
  • Homey shows the lock as a Matter 1.4.1 device over Thread;
  • the lock is still working normally in Homey more than a day later (lock/unlock and status updates).

This seems to demonstrate that Homey can operate the lock over Thread without any active Apple Thread Border Router.

However, I still cannot pair either of my two Nuki Ultra locks directly from Homey. Every direct commissioning attempt immediately ends with:

incorrect_state (0x0003)

So, in my case:

  • Direct pairing from Homey → always fails (incorrect_state)
  • Pair via iPhone → succeeds and produces a fully functional lock in Homey, without adding it to Apple Home.

Has anyone else observed the same behaviour?

9

Final update

I finally managed to get both Nuki Smart Lock Ultra locks working with Homey over Matter/Thread, without using Apple Home.

What solved the issue for my first lock was:

  • removing the existing Matter connection from the Nuki app;
  • removing Homey as a bridge from Apple Home;
  • powering off the Apple TV again;
  • commissioning the lock using “Pair via iPhone” from Homey.

The lock was added successfully and now works normally in Homey.

Direct pairing from Homey still immediately fails with incorrect_state (0x0003), but the “Pair via iPhone” method works reliably in my setup.

10

Thats what i wrote in my previous post. Pairing via Iphone directly to Homey works.