How can I retry a verification attempt?

Question:

  • How can I stop an ongoing verification attempt and try again?
  • Why am I getting an error: "Verification request [xxxxxxxxxxxxxxxxxxxxx] can't be cancelled now. Too many attempts to re-deliver have already been made"?
  • How can I cancel a Verify request?

Context:

A Verify request was made and you wish to either stop or restart it

Answer:

By default Verify blocks an attempt to initiate another Verify request for the same number while there is already one ongoing - therefore, do not implement a Retry button with another Verify call - this would be rejected outright.

Retries should be implemented with two subsequent calls:

1) Cancel the outstanding verification request

2) Issue a new verification request.

Use our Verify Control API to cancel an outstanding verification request.

Please note that Verify requests can only be cancelled before a TTS attempt has been made, if you attempt to cancel it after this time you will receive the error  "Verification request [xxxxxxxxxxxxxxxxxxxxx] can't be cancelled now. Too many attempts to re-deliver have already been made"

For this reason we would recommend you keep your pin_expiry times as short as possible, especially while testing to a limited range of numbers.

Have more questions? Submit a request