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?

1. Setup your paid Telesign account.

2. Retrieve your API Key and Customer ID from your Telesign Home Page.

3. Create or modify the settings file to include the API Key and Customer ID.

4. Restart CAS.

5. Navigate to your CAS Organization page and enable “Phone Lookup Providers”.

6. Choose the CAS options you wish to employ.

7. Activate this feature ALSO in: AML/KYC & Terminal Details

   1. THE FEATURE WILL NOT WORK UNLESS IT IS ACTIVATED IN ALL 3 PLACES.

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, do not change the filename).

CAS Organization

Change these settings as desired.

• More information about these settings: https://generalbytes.atlassian.net/wiki/spaces/ESD/pages/2748186625/Organization#Phone-Lookup-Provider

• Settings are 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!

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.

Disable Telesign in Organization:

Disable Telesign in each Terminal:

Disable Telesign in each AML/KYC setting: