Class Card
java.lang.Object
com.samsung.android.sdk.samsungpay.v2.card.Card
- All Implemented Interfaces:
android.os.Parcelable
This class provides card information related to the card management operations.
- Since:
- API Level 1.1
-
Nested Class Summary
-
Field Summary
Modifier and TypeFieldDescriptionstatic final String
Card is fully registered on Samsung Pay and current state is "active".static final String
Indicates that the key for card type.static final String
Indicates that the card type is credit card.static final String
Indicates that the card type is either credit or debit.static final String
Indicates that the card type is debit card.static final String
Indicates that the card type is gift card.static final String
Indicates that the card type is loyalty card.static final String
Indicates that the card type is transit card.static final String
Indicates that the card type is vaccine passstatic final String
Card is deleted from Samsung Pay.static final String
Card is registered on Samsung Pay, but its current status is "expired".
This might occur if the card or token expiration time has reached and Samsung Pay has not renewed it.static final String
Card is registered on Samsung Pay but not activated yet.
A notification of card activation is expected to be pushed to Samsung Pay in a moment.static final String
Card is not fully registered on Samsung Pay and current state is "pending provision".
Usually, this state returns when the user has not completed the secondary authentication(IDV).static final String
Card is registered on Samsung Pay and current state is "suspended".
Suspend can be triggered by issuer, card network, or the user.Fields inherited from interface android.os.Parcelable
CONTENTS_FILE_DESCRIPTOR, PARCELABLE_WRITE_RETURN_VALUE
-
Method Summary
Modifier and TypeMethodDescriptionAPI to get card brand.API to get unique identification of a card in Samsung Pay.android.os.Bundle
API to get extra card information(if any) related to the card.API to get current status of the card.
-
Field Details
-
ACTIVE
Card is fully registered on Samsung Pay and current state is "active".- Since:
- API Level 1.1
- See Also:
-
DISPOSED
Card is deleted from Samsung Pay.- Since:
- API Level 1.1
- See Also:
-
EXPIRED
Card is registered on Samsung Pay, but its current status is "expired".
This might occur if the card or token expiration time has reached and Samsung Pay has not renewed it.- Since:
- API Level 1.1
- See Also:
-
PENDING_PROVISION
Card is not fully registered on Samsung Pay and current state is "pending provision".
Usually, this state returns when the user has not completed the secondary authentication(IDV).- Since:
- API Level 1.1
- See Also:
-
SUSPENDED
Card is registered on Samsung Pay and current state is "suspended".
Suspend can be triggered by issuer, card network, or the user.- Since:
- API Level 1.1
- See Also:
-
PENDING_ACTIVATION
Card is registered on Samsung Pay but not activated yet.
A notification of card activation is expected to be pushed to Samsung Pay in a moment.- Since:
- API Level 2.3
- See Also:
-
CARD_TYPE
Indicates that the key for card type.- Since:
- API Level 1.8
- See Also:
-
CARD_TYPE_CREDIT_DEBIT
Indicates that the card type is either credit or debit. This is a valid type forAddCardInfo.setCardType(String)
- Since:
- API Level 1.1
- See Also:
-
CARD_TYPE_GIFT
Indicates that the card type is gift card.- Since:
- API Level 1.1
- See Also:
-
CARD_TYPE_LOYALTY
Indicates that the card type is loyalty card.- Since:
- API Level 1.1
- See Also:
-
CARD_TYPE_CREDIT
Indicates that the card type is credit card. This is a valid type forAddCardInfo.setCardType(String)
- Since:
- API Level 1.2
- See Also:
-
CARD_TYPE_DEBIT
Indicates that the card type is debit card. This is a valid type forAddCardInfo.setCardType(String)
- Since:
- API Level 1.2
- See Also:
-
CARD_TYPE_TRANSIT
Indicates that the card type is transit card.- Since:
- API Level 1.8
- See Also:
-
CARD_TYPE_VACCINE_PASS
Indicates that the card type is vaccine pass- Since:
- API Level 2.16
- See Also:
-
-
Method Details
-
getCardId
API to get unique identification of a card in Samsung Pay.- Returns:
- Unique ID to refer a card in Samsung Pay.
- Since:
- API Level 1.1
-
getCardBrand
API to get card brand.- Returns:
- Brand name of the card.
- Since:
- API Level 1.9
- See Also:
-
getCardInfo
public android.os.Bundle getCardInfo()API to get extra card information(if any) related to the card.- Returns:
- Extra cardInfo.
The following are list of extra card information provided on the bundle:
Keys Values AppToAppConstants.EXTRA_APP2APP_INTENT
String App2App Intent Name AppToAppConstants.EXTRA_APP2APP_PAYLOAD
String App2App Payload SpaySdk.EXTRA_LAST4_DPAN
String last 4 digit of DPAN SpaySdk.EXTRA_LAST4_FPAN
String last 4 digit of FPAN SpaySdk.EXTRA_CARD_TYPE
CARD_TYPE_CREDIT_DEBIT
CARD_TYPE_CREDIT
CARD_TYPE_DEBIT
CARD_TYPE_GIFT
CARD_TYPE_LOYALTY
CARD_TYPE_TRANSIT
SpaySdk.EXTRA_DEVICE_TYPE
SamsungPay#DEVICE_TYPE_PHONE
SamsungPay#DEVICE_TYPE_GEAR
SpaySdk.EXTRA_ISSUER_NAME
String issuerName (issuerCode for Korean issuers) - Since:
- API Level 1.1
-
getCardStatus
API to get current status of the card.- Returns:
- Current card status.
The status can be one of the following:
PENDING_PROVISION
PENDING_ACTIVATION
ACTIVE
SUSPENDED
DISPOSED
EXPIRED
- Since:
- API Level 1.1
-
Samsung Electronics.
Samsung Pay SDK 2.19.00 - Jun 12 2024