<!--
{
  "availability" : [
    "iOS: 26.2.0 -",
    "iPadOS: 26.2.0 -",
    "macCatalyst: 26.2.0 -",
    "macOS: 26.2.0 -",
    "tvOS: 26.2.0 -",
    "visionOS: 26.2.0 -",
    "watchOS: 26.2.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Matter",
  "identifier" : "/documentation/Matter/MTRCommissioningDelegate/commissioning(_:needsWiFiCredentialsWithScanResults:error:completion:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Matter"
    ],
    "preciseIdentifier" : "c:objc(pl)MTRCommissioningDelegate(im)commissioning:needsWiFiCredentialsWithScanResults:error:completion:"
  },
  "title" : "commissioning(_:needsWiFiCredentialsWithScanResults:error:completion:)"
}
-->

# commissioning(_:needsWiFiCredentialsWithScanResults:error:completion:)

Callback that gets called for a commissionee that supports Wi-Fi if
Wi-Fi network commissioning is required and Wi-Fi credentials were not
provided in MTRCommissioningParameters.

```
optional func commissioning(_ commissioning: MTRCommissioningOperation, needsWiFiCredentialsWithScanResults networks: [MTRNetworkCommissioningClusterWiFiInterfaceScanResultStruct]?, error: (any Error)?, completion: @escaping @Sendable (Data, Data?) -> Void)
```

```
optional func commissioning(_ commissioning: MTRCommissioningOperation, needsWiFiCredentialsWithScanResults networks: [MTRNetworkCommissioningClusterWiFiInterfaceScanResultStruct]?, error: (any Error)?) async -> (Data, Data?)
```

## Discussion

Commissioning will pause, including in cases when the network scan failed,
until the completion is invoked with the network and credentials the
commissionee should use, or until commissioning is stopped.  The provided
credentials are allowed to be nil for an open Wi-Fi network.

- error will be non-nil if a scan was attempted and failed.
- networks will be non-nil if a scan was attempted and succeeded.
- Both error and networks will be nil if no scan was performed.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)