Cancel verification request [Deprecated]

If the user decides to cancel the verification process, you should send a control request to the Verify API. This will terminate the verification process even if the user supplied the correct code.

Note: You can only cancel a verification request after 30 seconds, but before any second attempt is made.

Replace the following variables in the sample code with your own values:

KeyDescription
VONAGE_API_KEY

Your Vonage API key (see it on your dashboard).

VONAGE_API_SECRET

Your Vonage API secret (also available on your dashboard).

REQUEST_ID

The ID of the Verify request (this is returned in the API response when you send a verification code)

Write the code

Add the following to cancel-verification-code.sh:

curl \

View full source

Run your code

Save this file to your machine and run it:

sh cancel-verification-code.sh

Prerequisites

Add the following to build.gradle:

implementation 'com.vonage:server-sdk-kotlin:2.1.1'

Create a file named CancelVerification and add the following code to the main method:

val client = Vonage {
    apiKey(VONAGE_API_KEY)
    apiSecret(VONAGE_API_SECRET)
}

View full source

Write the code

Add the following to the main method of the CancelVerification file:

val response = client.verifyLegacy.request(VERIFY_REQUEST_ID).cancel()
println(response.status)

View full source

Run your code

We can use the application plugin for Gradle to simplify the running of our application. Update your build.gradle with the following:

apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''

Run the following gradle command to execute your application, replacing com.vonage.quickstart.kt.verify.legacy with the package containing CancelVerification:

gradle run -Pmain=com.vonage.quickstart.kt.verify.legacy.CancelVerification

Prerequisites

Add the following to build.gradle:

implementation 'com.vonage:server-sdk:9.3.1'

Create a file named CancelVerification and add the following code to the main method:

VonageClient client = VonageClient.builder()
        .apiKey(VONAGE_API_KEY)
        .apiSecret(VONAGE_API_SECRET)
        .build();

View full source

Write the code

Add the following to the main method of the CancelVerification file:

ControlResponse response = client.getVerifyClient().cancelVerification(VERIFY_REQUEST_ID);

String errorText = response.getErrorText();
if (errorText != null) {
    System.out.println("Cancellation failed: " + errorText);
}
else {
    System.out.println("Verification cancelled.");
}

View full source

Run your code

We can use the application plugin for Gradle to simplify the running of our application. Update your build.gradle with the following:

apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''

Run the following gradle command to execute your application, replacing com.vonage.quickstart.verify with the package containing CancelVerification:

gradle run -Pmain=com.vonage.quickstart.verify.CancelVerification

Prerequisites

Install-Package Vonage

Create a file named CancelVerificationRequest.cs and add the following code:

using Vonage;
using Vonage.Request;
using Vonage.Verify;

View full source

Add the following to CancelVerificationRequest.cs:


var credentials = Credentials.FromApiKeyAndSecret(vonageApiKey, vonageApiSecret);

View full source

Write the code

Add the following to CancelVerificationRequest.cs:

var client = new VonageClient(credentials);
var request = new VerifyControlRequest() { RequestId = requestId, Cmd = "cancel" };

View full source

Prerequisites

composer require vonage/client

Create a file named cancel.php and add the following code:

$basic  = new \Vonage\Client\Credentials\Basic(VONAGE_API_KEY, VONAGE_API_SECRET);
$client = new \Vonage\Client(new \Vonage\Client\Credentials\Container($basic));

View full source

Write the code

Add the following to cancel.php:

try {
    $result = $client->verify()->cancel(REQUEST_ID);
    var_dump($result->getResponseData());
}

catch(Exception $e) {
    echo 'Message: ' .$e->getMessage();
}

View full source

Run your code

Save this file to your machine and run it:

php cancel.php

Prerequisites

pip install vonage python-dotenv

Write the code

Add the following to cancel.py:

from vonage import Auth, Vonage

client = Vonage(Auth(api_key=VONAGE_API_KEY, api_secret=VONAGE_API_SECRET))

client.verify_legacy.cancel_verification(VERIFY_REQUEST_ID)

View full source

Run your code

Save this file to your machine and run it:

python verify_legacy/cancel.py

Prerequisites

gem install vonage

Create a file named cancel.rb and add the following code:

client = Vonage::Client.new(
  api_key: VONAGE_API_KEY,
  api_secret: VONAGE_API_SECRET
)

View full source

Write the code

Add the following to cancel.rb:

response = client.verify.cancel(VERIFY_REQUEST_ID)

View full source

Run your code

Save this file to your machine and run it:

ruby cancel.rb