Package com.thalesgroup.gemalto.d1.digitalcard

Interface DigitalCardService

public interface DigitalCardService

Service interface for digital card operations related to cardholder verification and device binding. binding.

Since:

4.3.0

Method Summary

Modifier and Type	Method	Description
void	approveBinding(String digitalCardID, String bindingReference, BindReason reason, D1Task.Callback<Void> callback)	Approves the device binding for a digital card.
void	approveCardholderVerification(String digitalCardID, VerificationReason reasonCode, D1Task.Callback<Void> callback)	Approves cardholder verification for a digital card.
void	unbindDevice(String digitalCardID, String bindingReference, UnbindReason reasonCode, D1Task.Callback<Void> callback)	Unbinds a device from a digital card.

Method Details

approveBinding

void approveBinding(@NonNull
 String digitalCardID,
 @NonNull
 String bindingReference,
 @Nullable
 BindReason reason,
 @NonNull
 D1Task.Callback<Void> callback)

Approves the device binding for a digital card.

Parameters:

digitalCardID - The unique identifier of the digital card.

bindingReference - Corresponds to Visa device index.

reason - The reason for device binding approval. If it is not provided, it defaults to BindReason.ISSUER_DECISION.

callback - The callback for the result. When it is successful, the returned argument of D1Task.Callback.onSuccess(Object) is always null.
Possible errors:

• D1Exception.ErrorCode.ERROR_NOT_LOGGED_IN
• D1Exception.ErrorCode.ERROR_NOT_AUTHORIZED
• D1Exception.ErrorCode.ERROR_DEVICE_ENVIRONMENT_UNSAFE
• D1Exception.ErrorCode.ERROR_CORE
• D1Exception.ErrorCode.ERROR_CARD_NOT_FOUND
• D1Exception.ErrorCode.ERROR_CARD
• D1Exception.ErrorCode.ERROR_INVALID_ARGUMENT

Since:

4.3.0

unbindDevice

void unbindDevice(@NonNull
 String digitalCardID,
 @NonNull
 String bindingReference,
 @Nullable
 UnbindReason reasonCode,
 @NonNull
 D1Task.Callback<Void> callback)

Unbinds a device from a digital card.

Parameters:

digitalCardID - The unique identifier of the digital card.

bindingReference - Corresponds to Visa device index.

reasonCode - The reason for device unbinding. If it is not provided, it defaults to UnbindReason.ISSUER_DECISION.

callback - The callback for the result. When it is successful, the returned argument of D1Task.Callback.onSuccess(Object) is always null.
Possible errors:

• D1Exception.ErrorCode.ERROR_NOT_LOGGED_IN
• D1Exception.ErrorCode.ERROR_NOT_AUTHORIZED
• D1Exception.ErrorCode.ERROR_DEVICE_ENVIRONMENT_UNSAFE
• D1Exception.ErrorCode.ERROR_CORE
• D1Exception.ErrorCode.ERROR_CARD_NOT_FOUND
• D1Exception.ErrorCode.ERROR_CARD
• D1Exception.ErrorCode.ERROR_INVALID_ARGUMENT

Since:

4.3.0

approveCardholderVerification

void approveCardholderVerification(@NonNull
 String digitalCardID,
 @Nullable
 VerificationReason reasonCode,
 @NonNull
 D1Task.Callback<Void> callback)

Approves cardholder verification for a digital card.

Parameters:

digitalCardID - The unique identifier of the digital card.

reasonCode - The reason for verification approval. If it is not provided, it defaults to VerificationReason.ISSUER_DECISION.

callback - The callback for the result. When it is successful, the returned argument of D1Task.Callback.onSuccess(Object) is always null.
Possible errors:

• D1Exception.ErrorCode.ERROR_NOT_LOGGED_IN
• D1Exception.ErrorCode.ERROR_NOT_AUTHORIZED
• D1Exception.ErrorCode.ERROR_DEVICE_ENVIRONMENT_UNSAFE
• D1Exception.ErrorCode.ERROR_CORE
• D1Exception.ErrorCode.ERROR_CARD_NOT_FOUND
• D1Exception.ErrorCode.ERROR_CARD
• D1Exception.ErrorCode.ERROR_INVALID_ARGUMENT

Since:

4.3.0