AbstractBankCallVerificationService
abstract class AbstractBankCallVerificationService : Service
| kotlin.Any | ||||
| ↳ | android.content.Context | |||
| ↳ | android.content.ContextWrapper | |||
| ↳ | android.app.Service | |||
| ↳ | com.google.android.gms.fraudprotect.AbstractBankCallVerificationService | |||
Abstract class for a bound service that a Bank App should extend to integrate with the Google Play services phone spoofing prevention feature.
To implement this service, extend this class and override the onVerifyCall method. Optionally, override onEvent to handle events from Google Play services. Declare the service in your AndroidManifest.xml, ensuring it is protected by the com.google.android.gms.fraudprotect.permission.CALL_VALIDATION_SERVICE permission and includes an <intent-filter> for the action AbstractBankCallVerificationService.SERVICE_ACTION.
Example manifest declaration:
<service
android:name=".YourBankCallVerificationService"
android:exported="true"
android:permission="com.google.android.gms.fraudprotect.permission.CALL_VALIDATION_SERVICE">
<intent-filter>
<action android:name="com.google.android.gms.fraudprotect.ACTION_VERIFY_CALL" />
</intent-filter>
</service>
Summary
Nested types |
|---|
fun interface AbstractBankCallVerificationService.VerdictSubmitterA functional interface for the Bank App to return the |
Constants |
|
|---|---|
const String |
The |
Public constructors |
|---|
Protected functions |
|
|---|---|
open Unit |
onEvent(requestId: String, event: CallVerificationEvent)Called when Google Play services sends an event regarding the call verification process. |
abstract Unit |
onVerifyCall(Abstract method to be implemented by the Bank App. |
Constants
SERVICE_ACTION
const val SERVICE_ACTION: String
The Intent action that must be declared in the <intent-filter> of this service in the AndroidManifest.xml.
Public constructors
Public functions
Protected functions
onEvent
protected open fun onEvent(requestId: String, event: CallVerificationEvent): Unit
Called when Google Play services sends an event regarding the call verification process.
A Bank App can override this method to log or react to CallVerificationEvent updates from Google Play services, such as timeouts or confirmations of actions taken (for example, call ended). The default implementation is a no-op.
| Parameters | |
|---|---|
requestId: String |
The unique identifier for the original verification request. |
event: CallVerificationEvent |
The |
onVerifyCall
protected abstract fun onVerifyCall(
requestId: String,
incomingNumber: String,
userPhoneNumbersSuffixes: List<String>,
submitter: AbstractBankCallVerificationService.VerdictSubmitter
): Unit
Abstract method to be implemented by the Bank App. This method is called by Google Play services when an incoming call from a number registered with the Bank is detected.
The implementation should perform the necessary checks (potentially involving backend systems) to determine if the call is legitimate for the current user context. Once a determination is made, the result MUST be sent back using the provided VerdictSubmitter.submit method.
This method is called on a Binder thread. Implementations should offload any long-running operations (like network requests) to a background thread to avoid blocking the Binder thread and potentially causing Application Not Responding (ANR) errors. The VerdictSubmitter object can be safely used from a background thread.
| Parameters | |
|---|---|
requestId: String |
A unique identifier for this specific verification request. Use this for logging or correlation if needed. |
incomingNumber: String |
The |
userPhoneNumbersSuffixes: List<String> |
A list of phone number suffixes associated with the SIM(s) on the user's device. This list may be empty if the user's phone number(s) cannot be determined. |
submitter: AbstractBankCallVerificationService.VerdictSubmitter |
The interface to invoke to return the verdict to Google Play services. |