Outbound voice geo permissions
Plivo can protect your account from fraud by restricting the set of countries your account can call. If, for example, you intend to place calls to numbers in North America only, you can disable call routes to all other continents and thereby reduce the risk of fraud. Similarly, if you’re running an inbound call center, or your use case doesn’t involve outbound calling to PSTN numbers, you can block outbound routes to all countries as a precautionary measure.
To manage geo permissions, navigate to Voice > Geo Permissions on the Plivo console.
Here you’ll see a list of all countries. You can filter the list by selecting specific geographic regions or countries.
Geo permission configurations are applied immediately to all calls initiated via Plivo APIs and Dial XML.
API calls to blocked countries are rejected with HTTP response code 403 and the error message “Calls to this destination country are barred.”
Calls initiated with Dial XML are dropped automatically. The hangup cause in the Call Detail Report for such calls is set to “Destination Country Barred” (Code 2030). See our list of hangup causes.
Calling premium numbers
Premium numbers are highly susceptible to International Revenue Share Fraud (IRSF), also known as toll fraud. We recommend blocking calls to premium numbers if your use case doesn’t involve calling them. You can do so by visiting Voice > Geo Permissions and clicking on the High Risk Permissions tab, then ticking the box in the upper right. Enabling this feature blocks calls to premium numbers across all countries.
API calls to blocked countries are rejected with HTTP response code 403 and the error message “Calls to this destination number are barred.”
Calls initiated with Dial XML are dropped automatically. The hangup cause in the Call Detail Report for such calls is set to “Destination Number Barred” (Code 2040).
These preferences also apply to calls initiated from subaccounts, unless the preferences are overridden for a subaccount.
Overriding preferences for specific subaccounts
Default preferences apply to all calls initiated from the main account and all subaccounts, but you can override geo permissions at the subaccount level.
To specify preferences for a subaccount, select the subaccount from the Account drop-down, enter your preferences, and click Save Changes.
For more information, see our an article in our support portal.
Geo permissions disabled by Plivo
Plivo analyzes call trends and disables geo permissions when we discover suspicious activity toward any country. You might see a “Disabled by Plivo” tag for a country or a message saying “Please contact Plivo support to re-enable geo permissions for any country that’s disabled below.” This indicates that Plivo has identified suspicious activity and disabled the geo permissions to avoid calls getting placed from your account to unknown numbers and destinations.
To unblock geo permissions in such instances, contact Plivo support.
These response codes will show in your call detail report if geo permissions are disabled:
SIP Response Code: 403 - Barred Country; Zentrunk Hangup Code: 4650 Description: The number has been blocked in geo permissions settings. Any calls made to this number belong to a specific country or number group will not go through since it has been barred.