---
title: Troubleshooting on iOS
description: How errors are reported by the pingonemfa module on iOS, the PingOneMFAError object, and fixes for common problems.
component: orchsdks
page_id: orchsdks:davinci:use-cases/pingone-mfa/ios/07-error-handling-and-troubleshooting
canonical_url: https://developer.pingidentity.com/orchsdks/davinci/use-cases/pingone-mfa/ios/07-error-handling-and-troubleshooting.html
llms_txt: https://developer.pingidentity.com/orchsdks/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
keywords: ["DaVinci", "MFA", "PingOne", "iOS", "Errors", "Troubleshooting", "SDK"]
section_ids:
  error-handling: Handling errors
  troubleshooting: Troubleshooting
---

# Troubleshooting on iOS

[icon: circle-check, set=far]PingOne [icon: apple, set=fab]iOS

## Handling errors

The module converts errors from the native PingOne MFA SDK into `PingOneMFAError`, so your app never works with the native SDK's error classes directly.

The module's functions throw a `PingOneMFAError` on failure:

Handling a PingOneMFAError

```swift
do {
    try await PingOneMFA.pair(pairingKey: pairingKey)
} catch let error as PingOneMFAError {
    print(error.message)
    error.internalErrorsList?.forEach { e in
        print("code=\(e.code) message=\(e.message)")
    }
} catch {
    print(error.localizedDescription)
}
```

Use the `message` property for display or simple logging. Use `internalErrorsList` for developer diagnostics only; it contains one entry per underlying native SDK error, each with the numeric error code, a message, and any additional server-provided diagnostic data. The entries in `internalErrorsList` are not suitable for showing to users.

The error codes match those listed in the [PingOne MFA SDK for iOS error codes](https://pingidentity.github.io/pingone-mobile-sdk-ios/documentation/pingonesdk/errorcode/).

## Troubleshooting

* Push notifications not received

  * Verify that the APNS push token was registered with `setDeviceToken`.

  * Confirm that push notification entitlements and capabilities are enabled in your Xcode project.

  * Check that APNS is configured in your PingOne environment.

* One-time passcode request fails with a device-not-paired error

  Ensure that `pair` was called and succeeded before requesting a passcode.

* Initialization or pairing fails unexpectedly

  * Check network connectivity to the PingOne MFA service.

  * Confirm that the geography passed to `initialize(geo:)` matches the region of your PingOne environment.