Comment on page
FAQs
Common questions and pitfalls when dealing with Verification Statuses.
You can expect our API to push an update to your webhook whenever the status of the address changes:
- 1.from initial no status to
"verified"
. - 2.from no status to
"not_at_address"
- 3.from no status to
"unknown"
- 4.from
"not_at_address"
to"verified"
etc
Status | Mode | Description |
---|---|---|
(no status) | first_time | the verification just got initiated for the first time |
verified | continuous | the verification process has completed and the address is verified. |
not_at_address | first_time / continuous | verification window has come to an end and the address was not verified due to user not frequenting the address.
Common cause for this is that the user created a wrong address hence appears as though the user did not frequent the address much` |
unknown | first_time / continuous | verification window has come to an end and the address was not verified due to lack of sufficient data from the user's device.
Common cause of this is that that user did not give sufficient location permissions or phone was offline |
We expect an address to be verified within 2-8 days.
Verification windows run for a maximum of 4 days inclusive of the 4th day. Between the 2nd and 4th day you can expect to get a status of
verified
if the address is verified. Otherwise on the 8th day you'd get a status update that the address is unknown
or not_at_address
. At this stage the 1st verification window will end and is considered complete.Immediately after you get either of these status changes, and if the client is still sending data, a new verification window is started with a new
address_verification_id
. The cycle then repeats one more time as described above.When a new verification has started it will be in the
first_time
mode. Once we have determined that the address is verified
or not_at_address
in the first or second window, we will change the mode to continuous
. If by the 8th day at the end of the second window we have not been able to determine if the address is verified
or not_at_address
then we will classify it as unknown
and change the mode to continuous
. In
continous
mode, we will continue to periodically collect data from the device to improve or update this status but do not post these changes via the webook or to the Dashboard. Last modified 3mo ago