--- title: "VTS Send Passcode" method: POST path: "/pws/vtis/v1/sendPasscode" tags: ["VTS - Visa To PTY"] --- # VTS Send Passcode `POST /pws/vtis/v1/sendPasscode` ## Request - Base URL: `https://api.uat.paymentology.com/ppws/api` - URL: `https://api.uat.paymentology.com/ppws/api/pws/vtis/v1/sendPasscode` - Auth: none declared VTS Send Passcode ## Request body - SendPasscodeModel - `otpMethodIdentifier` string, required - `otpValue` string, required - `tokenRequestorID` string - `tokenReferenceID` string - `panReferenceID` string - `lifeCycleTraceID` integer - `clientWalletAccountID` string - `otpReason` string - `otpExpirationDate` string - `encryptedData` string - `deviceInfo` DeviceInfo: Mada-DeviceInfo - `deviceId` string: Device Id VTS: Conditional MDES/MADA: Not present Apple Pay: Required - `serialNumber` string: Serial number of the device. Can be masked. VTS: Not present MDES/MADA: Optional Apple Pay: Not present - `imei` string: The IMEI number of the device being provisioned. VTS: Not present MDES/MADA: Optional Apple Pay: Not present - `msisdn` string: The msisdn of the device being provisioned VTS: Not present MDES/MADA: Optional Apple Pay: Not present - `deviceLanguageCode` string: Valid value is any ISO 639 Version 3 VTS: Optional MDES/MADA: Not present Apple Pay: Required - `deviceName` string: Readable name of the device VTS: Optional MDES/MADA: Optional Apple Pay: Required - `isoDeviceType` string: The 2 digit device type provided on the iso messages that the token is being provisioned to. Only present when provided by a Wallet Provider VTS: Not present MDES/MADA: Optional Apple Pay: Not present - `deviceManufacturer` string: Manufacturer of the device VTS: Optional MDES/MADA: Not present Apple Pay: Required - `deviceBrand` string: Brand of the device VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `deviceModel` string: Model of the device VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `formFactor` string: Valid values are: PHONE, MOBILEPHONE_OR_TABLET, TABLET etc.. VTS: Optional MDES/MADA: Optional Apple Pay: Required - `storageTechnology` string: Valid values are: DEVICE_MEMORY, DEVICE_MEMORY_PROTECTED, SE, TEESE etc.. VTS: Optional MDES/MADA: Optional Apple Pay: Not present - `paymentTypes` string[]: Valid values are: NFC, DSRP, ECOMMERCE VTS: Not present MDES/MADA: Optional Apple Pay: Not present - `osName` string: Valid values are: ANDROID, WINDOWS, TIZEN, BLACKBERRY, IOS, PAGARE_EMBEDDED_OS, ANDROID_WEAR, EMBEDDED_OS VTS: Optional MDES/MADA: Optional Apple Pay: Optional - `osVersion` string: The version of the device operating system VTS: Optional MDES/MADA: Optional Apple Pay: Not present - `osBuildId` string: Operating system build identifier VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `deviceLocation` string: Obfuscated geographic location of the device. Initially, when it is being provisioned, this contains the general location of the device. VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `deviceIPAddressV4` string: Ip address of the device at the time of provisioning. VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `locationSource` string: Valid values are: WIFI, CELLULAR, GPS, OTHER VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `tokenProtectionMethod` string: Valid values are: SOFTWARE, TRUSTED_EXECUTION_ENVIRONMENT, SECURE_ELEMENT, CLOUD VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `deviceNumber` string: Device number. VTS: Optional MDES/MADA: Not present Apple Pay: Optional - `fourLastDigitPhoneNumber` string: The last 4 digit of the phone number VTS: Not Present MDES/MADA: Not present Apple Pay: Optional - `deviceBluetoothMac` string: The mac of the bluetooth of the device. VTS: Not Present MDES/MADA: Not present Apple Pay: Optional - `timeZone` string: Device time zone TZ_Abbreviation VTS: Not Present MDES/MADA: Not present Apple Pay: Optional - `timeZoneSettings` string: Valid values: NETWORK_SET, CONSUMER_SET VTS: Not Present MDES/MADA: Not present Apple Pay: Optional - `deviceIndex` string: The index number from Visa where deviceId is stored. Required for token device binding. Conditional. VTS only. - `originalDeviceId` string - `originalDeviceType` string - `deviceIdType` string - `osId` string - `simSerialNumber` string - `deviceLostMode` string - `deviceBindingStatus` string - `decryptedData` VtsDecryptedData: Decrypted payload data from Visa Token Service (VTS) - `cardholderInfo` CardHolderInfo - `primaryAccountNumber` string - `cvv2` string - `name` string - `expirationDate` ExpirationDate - `month` string - `year` string - `billingAddress` BillingAddress - `line1` string - `line2` string - `city` string - `state` string - `country` string - `postalCode` string - `highValueCustomer` string - `riskAssessmentScore` string - `tokenInfo` TokenInfo - `token` string - `tokenType` 'SECURE_ELEMENT' | 'HCE' | 'CARD_ON_FILE' | 'ECOMMERCE' | 'QRC' | 'STATIC' | 'NA' - `tokenStatus` 'ACTIVE' | 'INACTIVE' | 'SUSPENDED' | 'DELETED' | 'DEACTIVATED' | 'CHECK_CONTEXT' - `tokenExpirationDate` ExpirationDate - `month` string - `year` string - `tokenAssuranceLevel` string - `numberOfActiveTokensForPAN` integer - `numberOfInactiveTokensForPAN` integer - `numberOfSuspendedTokensForPAN` integer - `originalToken` string - `originalTokenAssuranceLevel` string - `originalTokenRequestorID` string - `originalTokenReferenceID` string - `originalTokenType` string - `originalTokenAssuranceMethod` string - `tokenRequestorName` string - `autoFillIndicator` boolean - `tokenActivationDate` string - `tokenDeactivationDate` string - `lastTokenStatusUpdatedTime` string - `tokenAssuranceMethod` string - `riskInformation` RiskInformation - `deviceScore` string - `accountScore` string - `walletProviderRiskAssessment` string - `riskAssessmentScore` string - `walletProviderReasonCodes` string[] - `riskAssessmentStandardVersion` string - `phoneNumberScore` string - `tspScore` string - `walletScore` string - `cardScore` string - `issuerSpecialConditionCodes` string - `deviceInfo` DeviceInfo: Mada-DeviceInfo - `deviceId` string: Device Id VTS: Conditional MDES/MADA: Not present Apple Pay: Required - `serialNumber` string: Serial number of the device. Can be masked. VTS: Not present MDES/MADA: Optional Apple Pay: Not present - `imei` string: The IMEI number of the device being provisioned. VTS: Not present MDES/MADA: Optional Apple Pay: Not present - `msisdn` string: The msisdn of the device being provisioned VTS: Not present MDES/MADA: Optional Apple Pay: Not present - `deviceLanguageCode` string: Valid value is any ISO 639 Version 3 VTS: Optional MDES/MADA: Not present Apple Pay: Required - `deviceName` string: Readable name of the device VTS: Optional MDES/MADA: Optional Apple Pay: Required - `isoDeviceType` string: The 2 digit device type provided on the iso messages that the token is being provisioned to. Only present when provided by a Wallet Provider VTS: Not present MDES/MADA: Optional Apple Pay: Not present - `deviceManufacturer` string: Manufacturer of the device VTS: Optional MDES/MADA: Not present Apple Pay: Required - `deviceBrand` string: Brand of the device VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `deviceModel` string: Model of the device VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `formFactor` string: Valid values are: PHONE, MOBILEPHONE_OR_TABLET, TABLET etc.. VTS: Optional MDES/MADA: Optional Apple Pay: Required - `storageTechnology` string: Valid values are: DEVICE_MEMORY, DEVICE_MEMORY_PROTECTED, SE, TEESE etc.. VTS: Optional MDES/MADA: Optional Apple Pay: Not present - `paymentTypes` string[]: Valid values are: NFC, DSRP, ECOMMERCE VTS: Not present MDES/MADA: Optional Apple Pay: Not present - `osName` string: Valid values are: ANDROID, WINDOWS, TIZEN, BLACKBERRY, IOS, PAGARE_EMBEDDED_OS, ANDROID_WEAR, EMBEDDED_OS VTS: Optional MDES/MADA: Optional Apple Pay: Optional - `osVersion` string: The version of the device operating system VTS: Optional MDES/MADA: Optional Apple Pay: Not present - `osBuildId` string: Operating system build identifier VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `deviceLocation` string: Obfuscated geographic location of the device. Initially, when it is being provisioned, this contains the general location of the device. VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `deviceIPAddressV4` string: Ip address of the device at the time of provisioning. VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `locationSource` string: Valid values are: WIFI, CELLULAR, GPS, OTHER VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `tokenProtectionMethod` string: Valid values are: SOFTWARE, TRUSTED_EXECUTION_ENVIRONMENT, SECURE_ELEMENT, CLOUD VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `deviceNumber` string: Device number. VTS: Optional MDES/MADA: Not present Apple Pay: Optional - `fourLastDigitPhoneNumber` string: The last 4 digit of the phone number VTS: Not Present MDES/MADA: Not present Apple Pay: Optional - `deviceBluetoothMac` string: The mac of the bluetooth of the device. VTS: Not Present MDES/MADA: Not present Apple Pay: Optional - `timeZone` string: Device time zone TZ_Abbreviation VTS: Not Present MDES/MADA: Not present Apple Pay: Optional - `timeZoneSettings` string: Valid values: NETWORK_SET, CONSUMER_SET VTS: Not Present MDES/MADA: Not present Apple Pay: Optional - `deviceIndex` string: The index number from Visa where deviceId is stored. Required for token device binding. Conditional. VTS only. - `originalDeviceId` string - `originalDeviceType` string - `deviceIdType` string - `osId` string - `simSerialNumber` string - `deviceLostMode` string - `deviceBindingStatus` string - `userAccountAge` string - `walletAccountAge` string - `panAge` string - `deviceAge` string - `accountToDeviceBindingAge` string - `daysSinceConsumerDataLastAccountChange` string - `accountHolderName` string - `walletAccountHolderCardNameMatch` string - `numberOfActiveTokens` string - `deviceTokens` string - `userCountry` string - `userWallets` string - `walletTransactions` string - `numberOfTransactionsInLast12months` string - `distinctCardholderNames` string - `suspendedCardsInAccount` string - `deviceWithActiveTokens` string - `daysSinceLastAccountActivity` string - `provisioningAttemptsOnDeviceIn24Hours` string - `deviceCountry` string - `visaTokenScore` string - `visaTokenDecisioning` string - `walletAccountCountry` string - `activeTokensOnAllDeviceForAccount` string - `deviceInfo` DeviceInfo: Mada-DeviceInfo - `deviceId` string: Device Id VTS: Conditional MDES/MADA: Not present Apple Pay: Required - `serialNumber` string: Serial number of the device. Can be masked. VTS: Not present MDES/MADA: Optional Apple Pay: Not present - `imei` string: The IMEI number of the device being provisioned. VTS: Not present MDES/MADA: Optional Apple Pay: Not present - `msisdn` string: The msisdn of the device being provisioned VTS: Not present MDES/MADA: Optional Apple Pay: Not present - `deviceLanguageCode` string: Valid value is any ISO 639 Version 3 VTS: Optional MDES/MADA: Not present Apple Pay: Required - `deviceName` string: Readable name of the device VTS: Optional MDES/MADA: Optional Apple Pay: Required - `isoDeviceType` string: The 2 digit device type provided on the iso messages that the token is being provisioned to. Only present when provided by a Wallet Provider VTS: Not present MDES/MADA: Optional Apple Pay: Not present - `deviceManufacturer` string: Manufacturer of the device VTS: Optional MDES/MADA: Not present Apple Pay: Required - `deviceBrand` string: Brand of the device VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `deviceModel` string: Model of the device VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `formFactor` string: Valid values are: PHONE, MOBILEPHONE_OR_TABLET, TABLET etc.. VTS: Optional MDES/MADA: Optional Apple Pay: Required - `storageTechnology` string: Valid values are: DEVICE_MEMORY, DEVICE_MEMORY_PROTECTED, SE, TEESE etc.. VTS: Optional MDES/MADA: Optional Apple Pay: Not present - `paymentTypes` string[]: Valid values are: NFC, DSRP, ECOMMERCE VTS: Not present MDES/MADA: Optional Apple Pay: Not present - `osName` string: Valid values are: ANDROID, WINDOWS, TIZEN, BLACKBERRY, IOS, PAGARE_EMBEDDED_OS, ANDROID_WEAR, EMBEDDED_OS VTS: Optional MDES/MADA: Optional Apple Pay: Optional - `osVersion` string: The version of the device operating system VTS: Optional MDES/MADA: Optional Apple Pay: Not present - `osBuildId` string: Operating system build identifier VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `deviceLocation` string: Obfuscated geographic location of the device. Initially, when it is being provisioned, this contains the general location of the device. VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `deviceIPAddressV4` string: Ip address of the device at the time of provisioning. VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `locationSource` string: Valid values are: WIFI, CELLULAR, GPS, OTHER VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `tokenProtectionMethod` string: Valid values are: SOFTWARE, TRUSTED_EXECUTION_ENVIRONMENT, SECURE_ELEMENT, CLOUD VTS: Optional MDES/MADA: Not present Apple Pay: Not present - `deviceNumber` string: Device number. VTS: Optional MDES/MADA: Not present Apple Pay: Optional - `fourLastDigitPhoneNumber` string: The last 4 digit of the phone number VTS: Not Present MDES/MADA: Not present Apple Pay: Optional - `deviceBluetoothMac` string: The mac of the bluetooth of the device. VTS: Not Present MDES/MADA: Not present Apple Pay: Optional - `timeZone` string: Device time zone TZ_Abbreviation VTS: Not Present MDES/MADA: Not present Apple Pay: Optional - `timeZoneSettings` string: Valid values: NETWORK_SET, CONSUMER_SET VTS: Not Present MDES/MADA: Not present Apple Pay: Optional - `deviceIndex` string: The index number from Visa where deviceId is stored. Required for token device binding. Conditional. VTS only. - `originalDeviceId` string - `originalDeviceType` string - `deviceIdType` string - `osId` string - `simSerialNumber` string - `deviceLostMode` string - `deviceBindingStatus` string ## Response `200` Successful Response - CheckEligibilityResponse - `responseId` string - `error` Error - `errorCode` string - `errorDescription` string - `details` Details - `location` string - `message` string - `errorCode` string - `cardMetadata` CardMetaData: Mada-CardMetaData - `cardIssuer` string: Card Issuer Name. - `foregroundColor` string: Foreground color of the Digital Wallet entry for the card. Specified as a CSS style RGB triple, for example, rgb (23,122,235). - `backgroundColor` string: Background color of the Digital Wallet entry for the card. Specified as a CSS style RGB triple, for example, rgb (23,122,235). - `labelColor` string: Label color of the Digital Wallet entry for the card. Specified as a CSS style RGB triple, for example, rgb (23,122,235). - `shortDescription` string: A short description of the card. - `longDescription` string: A long description of the card. - `issuerProductConfigId` string: Profile id associated with the card. This is a required field if operationReasonCode = CARD_METADATA_UPDATE - `applicationInfo` CardMetadataApplicationInfo - `supportsTokenNotifications` boolean: Indicates whether the card supports token notifications for transactions originating on the device - `supportsFPANNotifications` boolean: Indicates whether the card supports FPAN notifications for all transactions that point back to the FPAN. - `transactionServiceURL` string: URL of the issuer Transaction History (Transaction Details) Web Service. - `messageServiceURL` string: URL of the message/offer web service that conforms to the API described to PNOs and issuers in the Card Notification Services API Specification. - `transactionPushTopic` string: Push topic that the issuer will use to notify the device that new transactions are available. - `messagePushTopic` string: Push topic that the notification provider will use to notify the device that new messages are available. - `appLaunchURL` string: URL to be passed to the associated issuer mobile app when launching it. - `appLaunchURLScheme` string: URL scheme that the application is registered for, in order to deep link from transaction notifications and show all transaction notifications. - `associatedStoreIdentifiers` string: A list of mobile application store item identifiers for associated issuer mobile banking application. Format is specific to a mobile store/phone platform. Only one item in the list is used: the first item identifier for an application compatible with the current device. - `associatedApplicationIdentifiers` string: Optional, similar to associatedStoreIdentifiers, but explicit App IDs. (Only applicable to SE DWPs.) - `cardArtData` CardArtData: Mada-CardArtData - `cardArtRefId` string[]: GUID-based file name for Cart Art Image file used by the Issuer while loading the image in the VRM system. - `termsAndConditionsId` string: GUID-based file name for Terms and Conditions text. File used by the issuer while loading the image in the VCCM system. - `contactInfo` ContactInfo - `contactWebsite` string: Customer Service website of the issuing bank. - `contactNumber` string: Customer Service phone number of the issuing bank. - `contactName` string: Name of the issuing bank. It may be used in combination with other text strings. - `contactEmail` string: Customer Service email address of the issuing bank. - `privacyPolicyURL` string: URL pointing to issuing bank’s privacy policy. - `termsAndConditionsURL` string: URL pointing to issuing bank’s terms and conditions for card. - `issuerPanReferenceId` string - `issuerProductConfigId` string ## Other responses - `404`: Webservices does not exist - `500`: Internal Server error ## Changes - **2026-11-03** `73c2771493b1`: 1 info - endpoint added [Operation history](https://skmtc.dev/paymentology/apis/payapi-docs/changes/pws/vtis/v1/sendPasscode/post.md) --- [API](https://skmtc.dev/paymentology/apis/payapi-docs.md) - [All operations](https://skmtc.dev/paymentology/apis/payapi-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/paymentology/apis/payapi-docs/revisions/73c2771493b1?raw)