Verify Anti-Fraud System

Verify customers have several options on how to manage fraud if fraudulent traffic has surfaced and a network block has been issued by the Verify Anti-Fraud System.

These features must be enabled for your account for you to use them. Contact customer support to request this.

Network Block Callbacks

A network block prevents Verify messages being sent over SMS and Voice channels on that network for your API key. In Verify, blocks are only issued for a temporary amount of time and will then allow traffic to resume as normal. If fraudulent traffic persists on a network, blocks will be issued for longer periods until they eventually become permanent. If a block becomes permanent, the only way for traffic to resume on this network is to use the Network Unblock API.

If you attempt to send a Verify request to a blocked network, you will receive a callback to your designated webhook indicating the request was blocked. For example:

Network Unblock API

When a network becomes blocked due to fraudulent traffic, customers can use the Network Unblock API to unblock a network. Before using the Network Unblock API we highly recommend checking the most recent blocked verification attempts sent to this network (or country) and confirm they are genuine verification attempts. If your latest traffic looks genuine then feel free to lift the block on a particular network. Be sure to carefully monitor your Verify traffic as it’s likely fraudsters have identified a vulnerability in your application’s 2FA implementation and will try sending fraudulent traffic to the same or different destinations.

WhatsApp and Email

WhatsApp and Email are new channels as part of Verify. When a block is issued on a network, WhatsApp and Email will continue to function as normal. In the below example, if there is a block on your API key for a given network, Verify will determine that SMS messages should not be sent and will deliver the one-time passcode (OTP) through WhatsApp.

Bypassing a Network Block using the Fraud Check parameter

The fraud_check parameter will bypass a network block for a single Verify request. Add the parameter fraud_check as demonstrated below to skip the fraud check. It is important to note, fraud_check set to false will bypass the network block only for the individual request (e.g. an end-user contacts your support team who need an escalation tool).

This parameter is optional and will default to true.