Package com.thalesgroup.gemalto.d1.card.cardservice

Interface CardService

public interface CardService

Main class of the Manage card service for the card issued by D1.

Since:

4.0.0

Method Summary

Modifier and Type	Method	Description
void	getCardList(D1Task.Callback<List<Card>> callback)	Retrieves the card list which is issued by D1.
void	getCardSettings(String cardID, D1Task.Callback<CardSettings> callback)	Retrieves the settings for card issued by D1.
void	getTransactionHistory(String cardID, TransactionQuery query, D1Task.Callback<List<CardTransactionRecord>> callback)	Retrieves the transaction history for card issued by D1
void	replaceCard(String cardID, StateReason reason, D1Task.Callback<String> callback)	Replaces the card issued by D1.
void	resumeCard(String cardID, D1Task.Callback<Void> callback)	Resumes the card issued by D1.
void	suspendCard(String cardID, D1Task.Callback<Void> callback)	Suspends the card issued by D1.
void	updateCardControlSettings(String cardID, CardControlSettings settings, D1Task.Callback<Void> callback)	Updates the control settings for card issued by D1.
void	updateCardLimitSettings(String cardID, CardLimitSettings settings, D1Task.Callback<Void> callback)	Updates the settings for card issued by D1.

Method Detail

suspendCard

void suspendCard(@NonNull
                 String cardID,
                 @NonNull
                 D1Task.Callback<Void> callback)

Suspends the card issued by D1.

Parameters:

cardID - The card identifier.

callback - The callback for the result. When the callback is successful, a null value will be returned.
Possible errors:

• D1Exception.ErrorCode.ERROR_CARD_OPERATION_NOT_ALLOWED
• D1Exception.ErrorCode.ERROR_CORE
• D1Exception.ErrorCode.ERROR_NOT_LOGGED_IN
• D1Exception.ErrorCode.ERROR_NOT_AUTHORIZED
• D1Exception.ErrorCode.ERROR_DEVICE_ENVIRONMENT_UNSAFE
• D1Exception.ErrorCode.ERROR_CARD_NOT_FOUND

Since:

4.0.0

resumeCard

void resumeCard(@NonNull
                String cardID,
                @NonNull
                D1Task.Callback<Void> callback)

Resumes the card issued by D1.

Parameters:

cardID - The card identifier.

callback - The callback for the result. When the callback is successful, a null value will be returned.
Possible errors:

• D1Exception.ErrorCode.ERROR_CARD_OPERATION_NOT_ALLOWED
• D1Exception.ErrorCode.ERROR_CORE
• D1Exception.ErrorCode.ERROR_NOT_LOGGED_IN
• D1Exception.ErrorCode.ERROR_NOT_AUTHORIZED
• D1Exception.ErrorCode.ERROR_DEVICE_ENVIRONMENT_UNSAFE
• D1Exception.ErrorCode.ERROR_CARD_NOT_FOUND

Since:

4.0.0

replaceCard

void replaceCard(@NonNull
                 String cardID,
                 @NonNull
                 StateReason reason,
                 @NonNull
                 D1Task.Callback<String> callback)

Replaces the card issued by D1.

Parameters:

cardID - The card identifier.

reason - StateReason, please find the list of all applicable state reasonsStateReason.getReplaceReasons(). When the SDK receives an invalid reason, the SDK will throw D1Exception.ErrorCode.ERROR_CARD_OPERATION_INVALID_REASON

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

• D1Exception.ErrorCode.ERROR_CARD_OPERATION_NOT_ALLOWED
• D1Exception.ErrorCode.ERROR_CARD_OPERATION_INVALID_REASON
• D1Exception.ErrorCode.ERROR_CORE
• D1Exception.ErrorCode.ERROR_NOT_LOGGED_IN
• D1Exception.ErrorCode.ERROR_NOT_AUTHORIZED
• D1Exception.ErrorCode.ERROR_DEVICE_ENVIRONMENT_UNSAFE
• D1Exception.ErrorCode.ERROR_CARD_NOT_FOUND

Since:

4.0.0

getCardList

void getCardList(@NonNull
                 D1Task.Callback<List<Card>> callback)

Retrieves the card list which is issued by D1. Use this API to retrieve the cardID and cardMetaData for each card issued by D1.

Parameters:

callback - The callback for the result. When the callback is successful, the returned argument of the D1Task.Callback.onSuccess(Object) is always not a null value.
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_MANAGED_BY_D1

Since:

4.0.0

getCardSettings

void getCardSettings(@NonNull
                     String cardID,
                     @NonNull
                     D1Task.Callback<CardSettings> callback)

Retrieves the settings for card issued by D1.

Parameters:

cardID - The card identifier.

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

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

Since:

4.0.0

updateCardControlSettings

void updateCardControlSettings(@NonNull
                               String cardID,
                               CardControlSettings settings,
                               @NonNull
                               D1Task.Callback<Void> callback)

Updates the control settings for card issued by D1.

Parameters:

cardID - The card identifier.

settings - The card control settings.

callback - The callback for the result. When the callback is successful, a null value will be returned.
Possible errors:

• D1Exception.ErrorCode.ERROR_CORE
• D1Exception.ErrorCode.ERROR_NOT_LOGGED_IN
• D1Exception.ErrorCode.ERROR_NOT_AUTHORIZED
• D1Exception.ErrorCode.ERROR_DEVICE_ENVIRONMENT_UNSAFE
• D1Exception.ErrorCode.ERROR_CARD_NOT_FOUND
• D1Exception.ErrorCode.ERROR_CARD_SETTINGS_OPERATION_NOT_ALLOWED
• D1Exception.ErrorCode.ERROR_CARD_SETTINGS_INVALID_FORMAT
• D1Exception.ErrorCode.ERROR_CARD_SETTINGS_INVALID_VALUE

Since:

4.0.0

updateCardLimitSettings

void updateCardLimitSettings(@NonNull
                             String cardID,
                             CardLimitSettings settings,
                             @NonNull
                             D1Task.Callback<Void> callback)

Updates the settings for card issued by D1.

Parameters:

cardID - The card identifier.

settings - The card limit settings.

callback - The callback for the result. When the callback is successful, a null value will be returned.
Possible errors:

• D1Exception.ErrorCode.ERROR_CORE
• D1Exception.ErrorCode.ERROR_NOT_LOGGED_IN
• D1Exception.ErrorCode.ERROR_NOT_AUTHORIZED
• D1Exception.ErrorCode.ERROR_DEVICE_ENVIRONMENT_UNSAFE
• D1Exception.ErrorCode.ERROR_CARD_NOT_FOUND
• D1Exception.ErrorCode.ERROR_CARD_SETTINGS_OPERATION_NOT_ALLOWED
• D1Exception.ErrorCode.ERROR_CARD_SETTINGS_INVALID_FORMAT
• D1Exception.ErrorCode.ERROR_CARD_SETTINGS_INVALID_VALUE

Since:

4.0.0

getTransactionHistory

void getTransactionHistory(@NonNull
                           String cardID,
                           @Nullable
                           TransactionQuery query,
                           @NonNull
                           D1Task.Callback<List<CardTransactionRecord>> callback)

Retrieves the transaction history for card issued by D1

Parameters:

cardID - The card identifier

query - Query for transaction history

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

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

Since:

4.0.0