OkHi Documentation
  • 👋Welcome Home
  • OVERVIEW
    • OkHi Product Overview
    • Integration process overview
    • Verification terminology
    • Case Studies
  • Best Practices
    • Integration Best Practices
    • Live Examples
    • Tips for PMs & QA
      • Testing & QA Guide
      • Publishing to app stores
        • Google Play store
        • Apple App Store
    • Tips for designers
  • Code Libraries
    • Developer Quick Start
      • Environment setup
      • Release Notes
    • Android Guide
      • Android Dependencies
      • Migrating to the latest library
    • iOS Guide
    • React Native Guide
      • React Native Dependencies
      • React Native troubleshoot guide
    • Expo React Native Guide
    • Flutter Guide
      • Flutter Dependencies
    • JS library
      • API Reference
      • OkCollect Webhook
      • Changelog
    • WooCommerce Plugin
      • Changelog
  • Verification Status
    • Customer Dashboard
    • Verification Status Updates
      • Webhook v3
        • Webhook Signature Verification Guide
      • Webhook v2
      • Verification Status API
      • Proof Of Address Certificate API
      • FAQs
    • API reference docs
  • Troubleshooting
    • Error Responses
    • Common technical pitfalls
    • How to reduce "Unknowns"
    • FAQs
      • Technical FAQs
      • Compliance FAQs
    • Get in touch
Powered by GitBook
On this page

Was this helpful?

  1. Troubleshooting

Error Responses

Below is a list of possible error responses, a description and possible fix when available.

service_unavailable

Location services are unavailable. Check the location permission settings.

play_services_unavailable (Android only)

Google Play service is unavailable. The device is not Google service compatible.

network_error

Could not reach OkHi servers. Check if a VPN is on or if the device has connectivity issues.

invalid_phone

The phone number does not meet the MSISDN format. Please make sure the user's phone number conforms to the MSISDN standard. e.g. +2348123456789 for an NG phone number.

unauthorized

The OkHi initialization failed due to the wrong credentials. Check that you are in a valid environment i.e. Sandbox or Production during OkHi initialization or check that the keys being used are correct i.e. branchId and clientKey.

permission_denied

The required permissions are not met to start OkHi. Please check the device permission and request location permission before launching the OkHi location manager

unsupported_platform

OkHi does not support the current platform being used. OkHi only supports Android, iOS, React Native, and Flutter for now.

bad_request

You are trying to start an address verification with no location ID. Make sure the selected location is valid.

location_services_unavailable

Device's location services is disabled. Please enable it in settings on iOS or use `reuqestEnableLocationServices` on android

PreviousAPI reference docsNextCommon technical pitfalls

Was this helpful?