Activate binding with customer service

Customer service is used as the ID&V method to activate a pending device binding.

This page continues the flow after Create device binding (yellow flow).

Prerequisites:

• You already started createBinding or resumeBinding.
• The issuer selected CUSTOMER_SERVICE as the ID&V method.
• Your merchant application can route the end user to customer service.

Flow

Customer service device binding flow.

Step	Description
1	The end user selects the customer service option in the merchant application.
2	The merchant application forwards the selection to the Thales backend.
3	The end user contacts the issuer to authenticate and confirm the device binding request.
4	The issuer accepts the device binding request and informs VTS.
5–6	VTS notifies the Thales backend, which notifies the merchant/PSP backend.
7	The merchant/PSP backend communicates the result to the merchant application.
8	The merchant application activates the binding locally in the Thales SDK.

In the customer service flow, the merchant application starts the device binding. The final approval comes from the server side.

Handle potential device/server desynchronization. Only activate the binding locally after you receive a successful status.

SDK integration

1. Select the customer service ID&V method

During createBinding or resumeBinding, submit Customer Service as the ID&V method.

Android

If the submission succeeds, the SDK calls onIssuerAuthenticationReady. If it fails, the SDK calls onError.

@Override
public void onIssuerAuthenticationRequired(IDVSession idvSession) { 
    // Submit CUSTOMER_SERVICE ID&V Method
    for (IDVMethod idvMethod : idvSession.getIdvMethods()) {
        if (idvMethod.getType().equals(IDVType.CUSTOMER_SERVICE)) {
            idvSession.selectIdvMethod(idvMethod);
        }
    }
}

@Override
public void onIssuerAuthenticationReady(IDVSession idvSession, 
                                        @Nullable OtpActivationStatus status) {
    
}

@Override
public void onError(TMGClientException exception) { 
    // Check if there's any error
    int errorCode = exception.getErrorCode();
    int errorMessage = exception.getMessage();
}

iOS

guard let idvSession = VisaService.shared.idvSession else {
    // no idv session
    return
}
// 1. Displays the list of IDV methods
do {
    let idvMethods = try idvSession.idvMethods
    let selectedIdvMethod = idvMethods[0] // user select an CUSTOMER_SERVICE idv method
    
    // 2. Submit the IDV method.
    idvSession.selectIDVMethod(selectedIdvMethod) { (result) in
        if let otpActivationStatus = result {
        
        } else {
            if selectedIdvMethod.type == .customerService {
                let value = selectedIdvMethod.value
                // 3. Verify through customer service.
            }
        }
    }
} catch let error {
    // Handles the error.
}

// 4. Failure in step 2, selectIDVMethod, will be handled in completionHandler.
VisaService.shared.completionHandler = { (session, error) in
    // 5. Check if it is a selectIDVMethod error.
    if let session = session,
        let error = error,
        error.description == TMGError.invalidIdvMethod.description {
        VisaService.shared.idvSession = session
        // 6. Retry the IDV flow.
    }
}

2. Get customer service data

Use the IDVMethod.value to display the customer service information returned by the issuer.

Android

The data that is needed for token activation can be retrieved from the IDVMethod object.

// Get the customer service data
String value = idvMethod.getValue();

iOS

let value = selectedIdvMethod.value

3. Activate the binding

After you receive a successful confirmation, activate the binding by calling activateBinding on the IDVSession.

Pass null (Android) or nil (iOS) to confirm that customer service verification is complete.

Android

@Override
public void onIssuerAuthenticationReady(IDVSession idvSession, 
                                        @Nullable OtpActivationStatus status) { 
    // Activate binding locally
    idvSession.activateBinding(null);
}

@Override
public void onError(TMGClientException exception) { 
    // Check if there's any error
    int errorCode = exception.getErrorCode();
    int errorMessage = exception.getMessage();
}

The result is returned via onSuccess or onError.

iOS

guard let idvSession = VisaService.shared.idvSession else {
    // no idv session
    return
}
// 1. Call activate
idvSession.activateBinding(withValue: nil)

VisaService.shared.completionHandler = { (session, error) in
    // 2. Binding successful
    if error == nil {
        
    }
}

The result is returned in completionHandler.

If activation fails, completionHandler returns an IDVSession and an error for retry.