Telesign Integration

“Access global digital identifiers and attributes”

The following Telesign services are integrated with CAS:

Identity: Access real-time phone number and subscriber attributes. Pay for each transaction call or save with volume based-discounts.
- Phone ID: Access phone number attributes.
- Contact: Get subscriber name, address, and more.

What does it do for you?

When enabled, Telesign is sent the phone number of the person using your BATM. They reply with the information that the telephone company has registered about that person, including the name & address. The line type describes the phone type that the person is using, which is useful for ensuring that only legitimate persons (with specific line types) can attempt registration.

Reduces registration fees (the number of false attempts are reduced).
Reduces registration headache, and prefills some basic Identity fields with known quantities.
Requires “Cellphone Number” in your AML/KYC authentication logic.

Setup a free trial with Telesign to explore the information it returns:

https://portal.telesign.com/signup
The free trial will not work with CAS, you must have a paid account to return the contact information.
The free trial will work with CURL and certain programming languages.

How do I use it in CAS?

Setup your paid Telesign account.
Retrieve your API Key and Customer ID from your Telesign Home Page.
Create or modify the settings file to include the API Key and Customer ID.
Restart CAS.
Navigate to your CAS Organization page and enable “Phone Lookup Providers”.
Choose the CAS options you wish to employ.
Activate the features ALSO in both: AML/KYC and Terminal Details.
1. Telesign must be enabled in ALL 3 AREAS to function fully as described.

Telesign Settings File

Create this file: /batm/config/telesign

sudo nano /batm/config/telesign

Add these properties (from your Telesign account) to the file:

aml_customer_id= 
aml_api_key_base64_encoded=
phone_lookup_customer_id= 
phone_lookup_api_key_base64_encoded=

Both aml_customer_id and phone_lookup_customer_id currently require the same (“Customer ID”) entry.
Both aml_api_key_base64_encoded and phone_lookup_api_key_base64_encoded currently require the same (“API Key”) entry.
Save the file (Ctrl+X) and exit (press Y when asked, do not change the filename).

CAS Organization

Change these Organization settings as desired. These are the master switches, and must be enabled for any Terminals to use the service.

More information about these settings: Organization | Phone Lookup Provider
After enabling it in Organization,
- each Terminal must also be enabled to use the Line Blocking service where implemented.
- each AML/KYC setting must also be enabled to use the Phone Identity service where implemented.
Line Blocking is additive. Terminal restrictions will selectively override Organization restrictions.
- Example: if the Organization allows VOIP calls, but the Terminal setting prohibits them, that Terminal setting will cause VOIP calls to be rejected from that BATM.

Disabling Telesign

Telesign is no longer available via the GB Cloud as of March 23, 2023.

You may setup Telesign with your own account as noted above, or disable it entirely. Telesign must be disabled in 3 different CAS locations!

If it is enabled in any of the CAS settings - but the service is down - it will block all customers!

These options are normally disabled (by default) - but if you accidentally enable them, you’ll encounter issues with new “Not Registered” Identities. The following options are scheduled for removal, but at least one Operator has run into this problem, so these instructions are being provided.

General Bytes Knowledge Base