Supported parameter values
The following tables describe the supported enum values for specific API parameters.
Note: Additional values may be introduced in the future, and the MPP should be able to accept new values.
WalletProviderDecisioningInfo.recommendationReasons
Valid value | Description |
| The account has existed for at least one year. The MPP may determine a longer account tenure to qualify. |
| Financial activity detected for at least six months and no suspicious activity detected for at least one year. |
| The digitization is requested for an additional device for the same primary account number and consumer account. There must be a currently active token that was previously digitized and activated on an existing device for the same primary account number and consumer account. |
| Digitization requested following an authenticated system update that erased non-restorable payment data. To qualify, this digitization must involve the same paymentAppInstanceId, primary account number, and consumer account associated with the previously activated token. |
| A companion cloud token is being provisioned from an existing device token which has been approved by the issuer using risk-based decisioning, within the system time validation window. |
| A companion cloud token is being provisioned from an existing device token, which was provisioned and successfully completed card holder authentication within the system time validation window. |
| A companion cloud token or recurring payment cloud token is being provisioned from an existing device token. A Device-Specific Reference Protocol (DSRP) cryptogram was provided and will be validated as proof of authentication. |
| The account is too new relative to the MPP service launch. |
| The account is considered too new for the provisioning request. |
| The account or card is too new for the provisioning request. |
| Account data was modified recently. |
| Suspicious activity is associated with this account. |
| The account is inactive. |
| The device contains suspended tokens. |
| The device has recently been reported lost. |
| There are excessive recent tokenization attempts on this device. |
| There is excessive recent tokenization activity on this device. |
| There are excessive non-matching account holder names detected on this device. |
| The device score is low. |
| The account score is low. |
| The tokenization attempt is non-domestic. |
| Unable to provide recommendation due to system issues |
| High fraud risk detected. Enhanced verification is recommended. |
| The phone number score is low. |
| The account holder is not actively participating in the request to tokenize the primary account number. |
DeviceInfo.formFactor
Valid value | Description |
| mobile phone |
| tablet computer |
| tablet computer or e-reader |
| watch |
| watch or wristband, including a fitness band, smart strap, disposable band, watch add-on, and security/ID band |
| card |
| sticker |
| PC or laptop |
| device peripherals, such as a mobile phone case or sleeve |
| tag, such as a key fob or mobile tag |
| jewelry, such as a ring, bracelet, necklace, or cuff links |
| fashion accessory, such as a handbag, bag charm, or glasses |
| garment, such as a dress |
| domestic appliance, such as a refrigerator or washing machine |
| vehicle, including vehicle attached devices |
| media or gaming device, including a set top box, media player, or television |
| device type that is not yet defined. Used by wallet to introduce a new device type that is not yet public knowledge. |
DeviceInfo.isoDeviceType
Valid value | Description |
| Mobile Network Operator (MNO) controlled removable secure element (SIM or UICC) personalized for use with a mobile phone or smartphone |
| Key Fob |
| watch using a contactless chip or a non-removable secure element not controlled by the MNO |
| mobile tag |
| wristband |
| mobile phone case or sleeve |
| mobile phone or smartphone with a non-removable secure element controlled by the MNO, for example, code division multiple access (CDMA) |
| removable secure element not controlled by the MNO, for example, memory card personalized for used with a mobile phone or smartphone |
| mobile phone or smartphone with a non-removable secure element not controlled by the mobile network operator |
| MNO controlled removable secure element (SIM or UICC) personalized for use with a tablet or e-book |
| tablet or e-book with a non-removable secure element controlled by the MNO |
| removable secure element not controlled by the MNO, for example, memory card personalized for use with a tablet or e-book |
| tablet or e-reader with a fixed (non-removable) secure element not controlled by the mobile network operator |
| mobile phone or Smartphone with a payment application running in a host processor |
| tablet or e-book with a payment application running in a host processor |
| mobile phone or smartphone with a payment application running in the trusted execution environment (TEE) of a host processor |
| tablet or e-book with a payment application running in the TEE of a host processor |
| watch with a payment application running in the TEE of a host processor |
| watch with a payment application running in a host processor |
| mobile phone |
| tablet |
| watch |
| sticker |
| personal computer |
| device peripheral |
| tag |
| jewelry |
| fashion accessory |
| garment |
| domestic appliance |
| vehicle |
| media or gaming device |
| virtual reality headset |
| other / none of the above |
DeviceInfo.osName
Valid value | Description |
| Google Android operating system |
| Microsoft Windows operating system |
| Tizen operating system |
| Apple iOS operating system |
| FitPay embedded operating system |
| Android Wear operating system |
| all embedded or real-time operating systems (RTOS) |
DeviceInfo.paymentTypes
Valid value | Description |
| The token supports NFC transactions. |
| The token can be processed by DSRPs. |
| The token can be used for e-commerce transactions. |
DeviceInfo.storageTechnology
Valid value | Description |
| device memory |
| device memory using a protected Trusted Platform Module (TPM) |
| Trusted Execution Environment |
| Secure Element |
| server host |
| Virtual Execution Environment |
DeviceInfo.captureTechnology
Valid value | Description |
| The account details are captured using the device camera. |
| The account details are manually entered. |
| The capture method is unknown. |
| The account details are captured using the reader mode. |
Approved.reason
Valid value | Description |
| The digitization request is approved based on the wallet provider's recommendation. |
| The digitization request is upgraded from yellow to green flow by Mastercard. |
Declined.reason
Valid value | Description |
| The digitization request is declined due to CVC2 verification failure. |
| The digitization request is declined based on the wallet provider's recommendation. |
| The digitization request is declined based on Alipay+'s recommendation. |
AplusDecisioningInfo.recommendationReasons
Valid value | Description |
| The service request is approved by Alipay+ risk control. |
| The service request is declined by Alipay+ risk control. |
| Alipay+ risk control requires this service request to be verified. |