Device Re-registration

Overview#

This document describes how to implement GCCS device re-registration and integrate with the Android SDK.

Feature Description#

What can be done if the user wishes to continue using GCCS after changing his/her mobile device?
It is possible to use GCCS features like before by user information verification and re-registration.
In this way, the user can use GCCS with a new mobile device.
To do so, the Android SDK will first check the user history and then verify the user by sending OTP code to their email.

User Verification and OTP Delivery#

Use verityUserToOtp() from GuardianSdk to call the API.
If the user has been verified in the past, he/she will receive the OTP code via email.

Parameter#

Key	Value	Description
userKey	String	User ID/Key
name	String	Name
email	String	Email

Example#

// User check and OTP deliveryGuardianSdk.getInstance().verityUserToOtp(params, new GuardianResponseCallback<RegisterOtpResponse>() {    @Override    public void onSuccess(RegisterOtpResponse result) {        ...    }
    @Override    public void onFailed(ErrorResult errorResult) {        Log.e(TAG, "Error code : " + errorResult.getErrorCode());        Log.e(TAG, "Error message : " + errorResult.getErrorMessage());    }});

RegisterOtpResponse#

Key	Value	Description
rtCode	0	Result code
rtMsg	String	Result message
seq	Int	seq

When the API call to verify the user and deliver OTP code is successful, the rtCode will be 0.

ErrorResult#

Key	Value	Description
errorCode	Int	Error code
errorMessage	String	Error message

If API call fails, the user will receive an errorCode.

Verifying Email Authentication#

It verifies email authentication by seq which is a return value of requestOtpEmail(), a verifying code on email, and email address. API is requested through verityOtpEmail() of GuardianSdk for email authentication request. If the verifying code for registration is correct, token value for registration will be passed.

Parameter#

Name	Value	Description
email	String	Email address to be authenticated
seq	Int	Authentication request seq
authNum	String	Authentication code

Example#

// Check duplicated register informationGuardianSdk.getInstance().verityOtpEmail("fnsvalue@fnsvalue.co.kr", 23, "452422", new GuardianResponseCallback<VerityOtpResponse>() {    @Override    public void onSuccess(VerityOtpResponse result) {        Log.i(TAG, "Result code : " + result.rtCode);        Log.i(TAG, "Token for registration : " + result.token);    }
    @Override    public void onFailed(ErrorResult errorResult) {        Log.e(TAG, "Error code : " + errorResult.getErrorCode());    }});

VerityOtpResponse#

Key	Value	Description
rtCode	0	Result code
result	Boolean	Check the correctness of verifying code
token	String	Token for registration authentication

It calls the Api that verifies email authentication. When it is a correct verifying code, it returns 0 for rtCode and true for result.

ErrorResult#

Key	Value	Description
errorCode	0	Error code

When failed to call API that checks duplication of register information, it returns errorCode.