Loading...
Loading...
Loading...
Loading...
(Specific to Android OAuth SDK - under early access currently)
Loading...
Loading...
What is Truecaller SDK ?
Truecaller SDK is a user consent based, instant, mobile number verification service, which you can use at any touch point in your user journey where you look to verify your users. To know more, read here
Why should I use Truecaller SDK ?
Leading products like 1mg, Gaana, OYO, Grofers, Myntra, and more, leverage Truecaller SDK to increase user growth and reduce user abandonment. To know more, read here
For which use cases can I use Truecaller SDK to verify mobile number of my app users ?
Number verification use cases can be around user on-boarding, login, registration, number verification at checkout etc. You may refer to this section to see some of the examples use cases of mobile number verification via Truecaller SDK
Which platforms can I use Truecaller SDK on ?
Truecaller SDK is available for :
Android apps [ learn more ]
iOS apps [ learn more ]
Mobile websites and interfaces [ learn more ]
Can I use Truecaller SDK to verify mobile numbers for all my app users globally ?
Truecaller SDK v2.0 has 2 key functionalities.
With the 1-tap verification functionality, you can verify mobile number of any active Truecaller app user (globally) on your app ( For native android & iOS apps, react native and mobile websites, PWAs on android )
With the missed call based functionality, you can verify mobile number of any user who may not be an active Truecaller app user. The missed call functionality is currently available for India market and on native android and react native platform only
Is Truecaller SDK free to use ?
Yes - Truecaller SDK is 100% free to use, no user verification limits whatsoever.
Do users need to type / provide their mobile number to complete verification via Truecaller SDK on my app ?
If the user has Truecaller app present on their device with a verified profile, Truecaller SDK facilitates zero effort user flow - which does not require users to type / provide their mobile numbers. This also helps in avoiding any typos.
In case the Truecaller app is not present on the user's device, the android SDK will facilitate the verification via drop call based background verification / SMS based OTP. For this, the user will have to input their mobile number on your android app interface to trigger the verification
What information does my app receive when users consent to verify via Truecaller SDK on my app ?
Once users consent to verify via Truecaller SDK on your platform, you shall receive verified mobile number and name for all users, and other profile information such as email, city etc.
Does Truecaller SDK receive any information from my app ?
Truecaller SDK does not capture any information from 3rd party platforms, and neither has any visibility to any user activities. The entire process of verification for Truecaller users is completely 1-way in nature, meaning that there is absolutely no data handshake involved.
For verifying non-Truecaller users in your android app, the SDK needs the mobile number and name of the user to complete the verification process.
How do I get started integrating Truecaller SDK / next steps for integration ?
For Android : Refer here
For Mobile Websites ( Currently for Android Browsers only ) : Refer here
for iOS : Refer here
For any queries, feel free to reach out to us via https://developer.truecaller.com/contact
How does Truecaller SDK work for android apps?
Please refer here for details.
Can I use Truecaller SDK to verify mobile numbers for all my app users globally?
Truecaller SDK v2.0 has 2 key functionalities:
With the 1-tap verification functionality, you can verify mobile number of any active Truecaller app user (globally) on your app.
With the missed call based functionality, you can verify mobile number of any user who may not be an active Truecaller app user. The missed call functionality is currently available for India market and on android platform only.
Where can I find the technical documentation for integration on my android app?
Please refer to the technical documentation here.
What is the right way / How do I implement the user flow in my app using Truecaller SDK?
Please refer here for details.
Why do I get "Partner Unauthorised [ ERROR_TYPE : 3 ] " error?
One app key can be used only for a particular combination of package name and SHA1. Different partner key needs to be used for any different combination of the two parameters.
You might be getting this error because you're either:
using a wrong app key
using the right key with either or both wrong package name and fingerprint
For details on generating and managing app keys for different app builds. Please refer here.
How can I find the SHA1 of my android app build?
Please refer here for details.
What is the TruecallerSDK.getInstance().isUsable() method used for?
The isUsable() method, helps you check if the Truecaller SDK can be used for user verification or not. Depending on the "sdkOptions" scope you have defined while initialising the Truecaller SDK ( WITH_OTP or WITHOUT_OTP ), below are the expected results:
WITH_OTP: In this case, Truecaller SDK can be used to verify existing Truecaller users as well as non-Truecaller app users ( via missed call/ OTP flow ), hence isUsable() method would always return "true".
WITHOUT_OTP: In this case, Truecaller SDK can be used to verify only existing Truecaller users, hence isUsable() method would return "true" only if the users have Truecaller SDK on their devices. It would return false otherwise.
How do I verify the authenticity of Truecaller SDK response?
Please refer here.
Does Truecaller SDK need any app permission?
For the verification of existing Truecaller users who have the app present on their smartphones, the SDK does not require any android system permissions, whatsoever.
For the automatic verification of users who don't have the Truecaller app on their devices, the SDK can facilitate the verification by sending a drop call in background / fallback SMS based OTP. If you choose to use this service for the verification of non-Truecaller users as well, the SDK will require you to ask for READ_CALL_LOG and READ_PHONE_STATE permissions. You can read more about the usage of these permissions here.
How can I test my application with Truecaller SDK integration to make it release ready?
For details on test scenarios and setup, please refer here.
Do I need to submit an app permissions declaration form while uploading my app on google play store?
If you are also using the missed call based non Truecaller user verification functionality of the SDK ( currently supported for India only ), you need specific phone permissions as described here. For submitting your application on Google play store, please refer to our recommended guidelines here.
"Number Verification App" for Shopify web stores
What is the “Truecaller Number Verification ” app ?
This app helps you verify your user’s mobile number identity anywhere during the checkout flow and also lets you capture mapped user profile details such as name, email, city etc. which can be auto-filled in your form to make the process simpler for your users and reduce checkout time.
Does the user need to do any manual efforts or share any information to go through the number verification flow ?
Truecaller verification flow is a totally effortless and no-OTP flow. The users don’t even need to type in their mobile number or wait for an OTP. The users simply need to give their consent to share their basic Truecaller profile details like verified mobile number, name, city etc.
Is there any technical integration or coding required to set up the app with my Shopify store ?
No, there is no need for any technical integration. You simply need to install the app and configure a few options to get started. The entire setup can be done within a matter of a few minutes.
What are the supported platforms for this app ?
This app is currently supported on Mobile websites on Android platform only
How can I know the details about all the configuration options available in the app ?
To know what each of the configuration option means, and what are the possible value options, please refer to this section of our documentation : https://docs.truecaller.com/truecaller-sdk/mobile-websites/integrating-with-your-mobile-website/initialisation
What happens if I change my store theme ?
When you change theme, you need to follow steps in Installation tab again, to install/customise the flow on product and/or checkout flows.
What is the pricing for this app ?
This app is completely free to use and has no commercials and verifications limits involved. You can verify any number of users on your website for free.
Can I use the number verification flow on "Product Page" ?
Yes, the app works with "Buy it Now" button on the "Product Page". To enable this, you need to disable the "Dynamic Checkout Button" from theme settings.
“Mobile Web SDK is currently supported only for browsers running on Android OS”
How does Truecaller SDK work for mobile websites and interfaces ?
Please refer .
Where can I find the technical documentation for integration on my mobile web app / PWA ?
Please refer to the technical documentation .
What is the right way / How do I implement the user flow in my app using Truecaller SDK ?
Please refer .
How much time does it take for Truecaller to send the access token callback once a user approves the verification request ?
As soon as a user clicks ‘Continue’ on the Truecaller profile dialog, our backend makes a POST request to the callback URL configured by you while creating the app from your developer account
In case users deny sharing their information, we immediately send you an error response on the same callback URL
The entire process normally takes a few milliseconds
What should I do once I receive user’s access token on my callback endpoint ?
Please refer
I am unable to add the callback URL to my developer account
The callback URL you add has to be an ‘https’ endpoint, and you won’t be able to add an ‘http’ endpoint. Please ensure that you have SSL setup before adding the callback URL For guidelines on properly setting up your callback URL, please refer .
What is request ID parameter in the deep link schema ?
Request ID corresponds to a unique identifier that you can set from your end while initiating any verification request. Once users give their consent for sharing the profile information with your mobile web app, we share the same request ID to you along with the access token on your callback URL. This can be used as a request correlation for mapping.
The request ID parameter needs to be a URL safe string with a length of minimum 8 characters and a maximum of 64 characters
How can I access my Truecaller developer account ?
You can create your Truecaller developer account by signing up here : https://developer.truecaller.com/sign-up
If you already have a Truecaller developer account, you can simply login to your account here : https://developer.truecaller.com/login
What can I do with my Truecaller developer account ?
Once you setup your Truecaller developer account you can:
create new applications and get respective app keys for using Truecaller SDK
edit an existing app
reset your account password
How can I add an app in my account ?
For Android apps, you need a valid app name, package name, SHA1 fingerprint and Google app hash code ( optional ) for your app build
For iOS apps, you need a valid app name, bundle Id and a teamId
For mobile web apps, you need a valid name, public url [ domain name ] for the web app and a publicly accessible callback URL [ an endpoint on your server where Truecaller’s server will post a user’s access token once they give consent to share their Truecaller profile with your app ]
Things that I need to keep in mind -
While creating a new app, you cannot have :
more than one active android app with the same combination of package name and SHA1 fingerprint
more than one active iOS app with the same bundle Id and teamId
more than one active mobile web app with the same public url and callback URL
If you want a new key for the same combination of params, you will need to deactivate the existing app first and then create a new one with the same identifiers
While editing an already existing app, you can only edit the following :
App name in case of android / iOS apps
Callback URL in case of web apps [ Please note that once you change the callback URL, it might take up to 30 minutes for the caching to clear out and reflect in our systems ]
You will not be able to edit main identifiers of apps such as package name, fingerprint, bundleId, teamId In case you need to have an app with the same package name but a different fingerprint, you should create a new app. You can also activate and deactivate your application. You cannot activate an application with identifiers that are already used by any of your existing apps.
I have more than one developer account. I wish to have only one account through which I should be able to manage all my apps
If you have more than one account and wish to use only one, please contact us here by sending :
your existing account's email id
existing app details
email id of the new account which you wish to continue using
We will make sure we map your existing apps to the single account you wish to use.
Get detailed answers to all your queries around Truecaller SDK here.