Package com.thalesgroup.gemalto.d1.messaging

Interface MessagingService

public interface MessagingService

Main class of the Messaging service for the Card issued by D1.

Since:

4.0.0

Method Summary

Modifier and Type	Method	Description
void	getMessageList(D1Task.Callback<List<Message>> callback)	To retrieve message list for the current consumer.
void	markMessageListAsRead(List<String> messageID, D1Task.Callback<Void> callback)	To mark the message as read.
void	registerMessageNotification(D1Task.Callback<Void> callback)	To register the notification for card issued by D1.
void	unregisterMessageNotification(D1Task.Callback<Void> callback)	To unregister notification for card issued by D1.

Method Detail

registerMessageNotification

void registerMessageNotification(@NonNull
                                 D1Task.Callback<Void> callback)

To register the notification for card issued by D1.

The SDK registers the token to the server. Hence, D1Task.Builder.setApplicationProfileId(String) and MessagingService.updatePushToken should be called before calling this API. Otherwise, the SDK will either return IllegalArgumentException or D1Error.Code.pushTokenNotFound.

Parameters:

callback - The callback is invoked when the operation is completed. Notification is registered when the callback is successful.
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_PUSH_TOKEN_NOT_FOUND
• D1Exception.ErrorCode.ERROR_CARD_NOT_MANAGED_BY_D1

Since:

4.0.0

unregisterMessageNotification

void unregisterMessageNotification(@NonNull
                                   D1Task.Callback<Void> callback)

To unregister notification for card issued by D1.

Parameters:

callback - The callback is invoked when the operation is completed. Notification is unregistered when the callback is successful.
Possible errors:

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

Since:

4.0.0

getMessageList

void getMessageList(@NonNull
                    D1Task.Callback<List<Message>> callback)

To retrieve message list for the current consumer. The message is related to activities in the card issued by D1.

Parameters:

callback - The callback is invoked when the operation is completed. When the callback is successful, the list of messages is returned.
Possible errors:

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

Since:

4.0.0

markMessageListAsRead

void markMessageListAsRead(@NonNull
                           List<String> messageID,
                           @NonNull
                           D1Task.Callback<Void> callback)

To mark the message as read. The message is related to activities in the card issued by D1.

Parameters:

messageID - The list of message IDs.

callback - The callback is invoked when the operation is completed.
Possible errors:

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

Since:

4.0.0