v6.0.1
  • 👋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
  • Location
  • Multiple Addresses
  • Priming
  • Status
  • Notification for opt-out

Was this helpful?

  1. Troubleshooting

Common technical pitfalls

PreviousError ResponsesNextHow to reduce "Unknowns"

Last updated 9 months ago

Was this helpful?

Over the years of our integrations with multiple businesses, we have come to realize some of the common mistakes developers make during our integration.

Location

A user's location is needed all the time during verification and it is important that this is true before and after a user's address. "Always" for iOS and "Allow all the time" for Android.

Multiple Addresses

A user should not be able to create multiple duplicate addresses for the same location. You can use the OkHi Address Book logic to be able to ensure to not create duplicates for the same location for a user. Address creation should be one at a time, and ideally, controlled by your server so a user is only allowed to create another address if the previous address status comes back as unknown or not at address. Note that a user may have multiple verifications running in parallel on the same device for different locations.

Priming

Priming a user simply means you show the user the necessary information before requesting their sensitive location permission and user data. It is important you do this for transparency and also required by the Application stores because of the first reason. Follow this link to .

Status

You should always make sure your user sees an update of their address somewhere in your dashboard when they log into your app as the image below shows.

Notification for opt-out

What happens to data if users opt out?

When a user "opts out" via their Okhi.me profile, we immediately stop collecting further data on that user. We retain all data that has been provided by or collected from the user up to that point for the required legal limits and customers have access to this data as well.

In order to comply with data privacy requirements, by law we need to (a) notify a user that we are using their location data and (b) provide the option for users to opt out of this data tracking. We do this by notifying users via email, SMS or WhatsApp with a link to their profile on where they can manage these permissions. It can be useful (and is required in cases where we do not send notifications to users) to provide this link in your user profiles for them to manage their address permissions & use.

www.okhi.me
learn more
Example of how to display the verification status