Package com.thalesgroup.gemalto.d1.card

Interface D1PushWallet

public interface D1PushWallet

Method Summary

Modifier and Type	Method	Description
void	activateDigitalCard(String cardID, OEMPayType oemType, D1Task.Callback<Void> callback)	Activate the digital card which has been digitized but not yet done ID&V (Step up authentication - Yellow Flow inApp Verification).
void	activateDigitalCard(String digitalCardID, D1Task.Callback<Void> callback)	Activate the digital card which has been digitized but not yet done ID&V (Step up authentication - Yellow Flow inApp Verification).
void	activateSamsungPay()	Samsung Pay only.
void	addDigitalCardToOEM(String cardID, OEMPayType oemType, Activity activity, D1Task.Callback<Object> callback)	Add Digital Card for a given cardID for OEM Type (Google Pay or Samsung Pay).
void	getCardDigitizationState(String cardID, OEMPayType oemType, D1Task.Callback<CardDigitizationState> callback)	Check if the card has been digitized or not.
void	updateSamsungPay()	Samsung Pay only.

Method Details

activateSamsungPay

void activateSamsungPay()
                 throws D1Exception

Samsung Pay only.

An utility function to bring the Samsung Pay app to a state in which cards can be added. End user need to sign-in into Samsung Pay app.

Integrator should call this API when D1PushWallet.addDigitalCardToOEM failed with D1Exception.ErrorCode.ERROR_SPAY_SETUP_NOT_COMPLETED
Possible errors:

• D1Exception.ErrorCode.ERROR_SPAY_NOT_SUPPORTED

Throws:

D1Exception

updateSamsungPay

void updateSamsungPay()
               throws D1Exception

Samsung Pay only.

An utility function to bring a user to update their Samsung Pay app.

Integrator should call this API when D1PushWallet.addDigitalCardToOEM failed with D1Exception.ErrorCode.ERROR_SPAY_NEED_TO_UPDATE
Possible errors:

• D1Exception.ErrorCode.ERROR_SPAY_NOT_SUPPORTED

Throws:

D1Exception

getCardDigitizationState

void getCardDigitizationState(@NonNull
 String cardID,
 @NonNull
 OEMPayType oemType,
 @NonNull
 D1Task.Callback<CardDigitizationState> callback)

Check if the card has been digitized or not. Use this API to determine if we need to show Add to Wallet button on the Application.

Parameters:

cardID - The card identifier

oemType - The oemType (Google Pay or Samsung Pay)

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_NOT_LOGGED_IN
• D1Exception.ErrorCode.ERROR_NOT_AUTHORIZED
• D1Exception.ErrorCode.ERROR_DEVICE_ENVIRONMENT_UNSAFE
• D1Exception.ErrorCode.ERROR_GPAY_NOT_SUPPORTED
• D1Exception.ErrorCode.ERROR_SPAY_NOT_SUPPORTED
• D1Exception.ErrorCode.ERROR_CORE
• D1Exception.ErrorCode.ERROR_SPAY
• D1Exception.ErrorCode.ERROR_GPAY
• D1Exception.ErrorCode.ERROR_CARD

addDigitalCardToOEM

void addDigitalCardToOEM(@NonNull
 String cardID,
 @NonNull
 OEMPayType oemType,
 @Nullable
 Activity activity,
 @NonNull
 D1Task.Callback<Object> callback)

Add Digital Card for a given cardID for OEM Type (Google Pay or Samsung Pay).

Integrator must override the Activity.onActivityResult() and pass the result back to SDK using D1Task.handleCardResult(int, int, Intent) API

Parameters:

cardID - The card identifier

oemType - The oemType (Google Pay or Samsung Pay)

activity - The caller activity. Set this value if the 'activity' value of ConfigParams.buildConfigCard(Activity, OEMPayType, String, String) is null or they are different. Otherwise, you can set it to `null`.

callback - The callback for the result. When it succeeds, the returned argument of the 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_GPAY_NOT_SUPPORTED
• D1Exception.ErrorCode.ERROR_SPAY_NOT_SUPPORTED
• D1Exception.ErrorCode.ERROR_CORE
• D1Exception.ErrorCode.ERROR_SPAY
• D1Exception.ErrorCode.ERROR_GPAY
• D1Exception.ErrorCode.ERROR_CARD

See Also:

• D1Task.handleCardResult(int, int, Intent)

activateDigitalCard

void activateDigitalCard(@NonNull
 String cardID,
 @NonNull
 OEMPayType oemType,
 @NonNull
 D1Task.Callback<Void> callback)

Activate the digital card which has been digitized but not yet done ID&V (Step up authentication - Yellow Flow inApp Verification).

Integrator should call this API when the return state of getCardDigitizationState(String,OEMPayType, D1Task.Callback) is CardDigitizationState.PENDING_IDV

Parameters:

cardID - The card ID

oemType - The oemType (Google Pay or Samsung Pay)

callback - The callback for result. When it succeeds, the returned argument of the 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
• D1Exception.ErrorCode.ERROR_CARD_NO_PENDING_IDV
• D1Exception.ErrorCode.ERROR_SPAY
• D1Exception.ErrorCode.ERROR_GPAY

activateDigitalCard

void activateDigitalCard(@NonNull
 String digitalCardID,
 @NonNull
 D1Task.Callback<Void> callback)

Activate the digital card which has been digitized but not yet done ID&V (Step up authentication - Yellow Flow inApp Verification).

Integrator should call this API to activate a digital card when a wallet app redirect digital card activation to the Issuer app.

Parameters:

digitalCardID - The digital card identifier

callback - The callback for result. When it succeeds, the returned argument of the D1Task.Callback#onSuccess(Void) 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

Since:

3.2.0