Digital Wallet Token
A Digital Wallet Token is created when customer manually or through the action in an app, provisions a card into a Digital Wallet.
Digital Wallet Tokens are returned as part of the digitalWalletTokens
array property on the card object. Multiple tokens from different wallets and devices can be associated to one card at any time.
Relevant events are triggered when a token
is created: Digital Wallet Tokenization Events
digitalWalletToken Object
Property | Data Type (length) | Description |
---|---|---|
device * | object | digitalWalletDevice object representing device information this token is provisioned on. |
isDeviceProvisioned * | boolean | Whether or not a token has been provisioned onto a device. |
panReferenceId * | string | Card network-generated unique digital wallet token PAN reference ID. Unique within the card network. |
token * | string | The unique card token representation on the device. |
tokenReferenceId * | string | Card network-generated unique digital wallet token reference ID unique within the card network. |
tokenRequestorId * | enum | The unique id representing a requestor on the card network. This property correlates with tokenRequestorName . Possible values:- 40010030273 : ApplePay- 40010075001 : GooglePay- 40010043095 : SamsungPay- 40010075338 : VisaCheckout |
tokenRequestorName * | enum | Name representation of tokenRequestorId . Possible values:- ApplePay : 40010030273- GooglePay : 40010075001- SamsungPay : 40010043095- VisaCheckout : 40010075338 |
tokenStatus * | enum | Possible values: - ActiveForPayment : From this status tokenStatus can change to SuspendedTemporarily (for various potential fraud precaution reasons) or DeactivatedPermanently if user removes card from the wallet.- Initiated : Token can be in this status when customer adds a PAN manually into the wallet and is in the process of validating a One Time Passcode that is sent through SMS. Once One Time Passcode is successfully entered then status will change to ActiveForPayment - SuspendedTemporarily : From this status tokenStatus can change to ActiveForPayment (for "reverting" various potential fraud precaution reasons) or DeactivatedPermanently if user removes card from the wallet.- DeactivatedPermanently : Once token is in this status it can not go back to any other status and is permanently unusable. |
tokenType * | enum | Type of wallet token. Possible values: - Card on file - Secure element .- Cloud based payment/HCE - E-Commerce Enabler |
walletInformation * | object | digitalWalletInformation object representing wallet information this token is provisioned on. |
digitalWalletDevice Object
Property | Data Type (length) | Description |
---|---|---|
deviceId * | string | Digital wallet device id. Returned if digital wallet is configured to be used with a device. |
deviceIpAddress * | string | Device ip address at the time of token provisioning. |
deviceLanguageCode * | string | 3 letter code representing laguage device is configured to use. |
deviceLocation * | string | Conditionally sent by the aquirer in the latitude/longitude format. |
deviceName * | string | Digital wallet provided device name. |
deviceNumber * | string | Phone number device is associated with. This may be returned as only last 4 digits of the phone number. |
deviceType * | enum | Device type digital wallet token is provisioned to. Possible values: - Card - MobilePhone - Tablet - Watch - MobileDevice - FashionAccessory - HomeAppliance - KeyFob - MediaOrGamingDevice - MobileDeviceAccessory - PCOrLaptop - Vehicle - UnknownOther |
digitalWalletInformation Object
Property | Data Type (length) | Description |
---|---|---|
panSource * | enum | - KeyEntered : Manually added PAN to the wallet.- OnFile : Recurring billing activity using a PAN provided to a merchant by a customer, e.g., Netfilix monthly recurring billing.- MobileBankingApp : Push provisioned PAN from within an app. |
walletAccountId * | string | Digital wallet provider's unique card holder account id. This field is present for Google Pay and Samsung Pay wallets. |
walletEmailAddressHashed * | string | Digital wallet provider's hashed email. This field is present for Apple Pay, Google Pay, and Samsung Pay wallets. |
walletProviderDeviceScore * | string | Digital wallet provided device score. |
walletProviderReasonCodes * | string | Digital wallet provided provisioning decision reason codes. |
walletProviderRiskAssessmentType * | string | Digital wallet provider's risk assessment. Possible values: - Approved - ApprovedConditionally - NotApproved |
walletProviderRiskAssessmentVersion * | string | Digital wallet provider's risk assessment version. |
*Property is nullable and may not be returned
Updated 12 months ago