---
title: "Request Activation Methods"
method: POST
path: "/pws/mada/issuerServices/1.0/requestActivationMethods/"
tags: ["Mada Pay - MadaPay To PTY (Beta)"]
---

# Request Activation Methods

`POST /pws/mada/issuerServices/1.0/requestActivationMethods/`

## Request

- Base URL: `https://api.uat.paymentology.com/ppws/api`
- URL: `https://api.uat.paymentology.com/ppws/api/pws/mada/issuerServices/1.0/requestActivationMethods/`
- Auth: none declared

Request Activation Methods

## Request body

- RequestActivationMethods: Mada-RequestActivationMethods
  - `requestId` string
  - `contentGroupId` string
  - `tspId` string
  - `correlationId` string
  - `tokenRequestorId` string
  - `panReferenceId` string
  - `tokenReferenceId` string
  - `panSource` string
  - `services` string[]
  - `walletProviderId` string
  - `paymentAppInstanceId` string
  - `accountIdHash` string
  - `mobileNumberSuffix` string
  - `tokenType` 'SECURE_ELEMENT' | 'HCE' | 'CARD_ON_FILE' | 'ECOMMERCE' | 'QRC' | 'STATIC' | 'NA'
  - `otpReason` string
  - `otpMaxReached` 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
  - `encryptedData` string
  - `decryptedData` MadaPayDecryptedData: Decrypted payload data from Mada Pay tokenization service
    - `cardInfoData` CardInfoData
      - `accountNumber` string
      - `securityCode` string
      - `name` string
      - `expirationDate` ExpirationDate
        - `month` string
        - `year` string
      - `billingAddress` Address
        - `line1` string
        - `line2` string
        - `city` string
        - `state` string
        - `country` string
        - `postalCode` string
        - `countrySubdivision` string
        - `keyValues` Entry[]
          - `key` string: Key
          - `value` string: Value
      - `highValueCustomer` boolean
      - `riskAssessmentScore` string
      - `source` string
      - `dataValidUntilTimeStamp` string
      - `sourceIp` string
      - `deviceLocation` string
      - `consumerIdentifier` string
      - `paymentAccountReference` string
      - `accountHolderData` AccountHolderData
        - `emailAddress` string
        - `countryDialInCode` string
        - `phoneNumber` string
    - `tokenData` TokenData
      - `token` string
      - `tokenType` 'SECURE_ELEMENT' | 'HCE' | 'CARD_ON_FILE' | 'ECOMMERCE' | 'QRC' | 'STATIC' | 'NA'
      - `tokenStatus` 'ACTIVE' | 'INACTIVE' | 'SUSPENDED' | 'DELETED' | 'DEACTIVATED' | 'CHECK_CONTEXT'
      - `sequenceNumber` string
      - `tokenExpiry` ExpirationDate
        - `month` string
        - `year` string
      - `tokenAssuranceLevel` string
      - `numberOfActiveTokensForPAN` integer
      - `numberOfInactiveTokensForPAN` integer
      - `numberOfSuspendedTokensForPAN` integer
      - `tokenActivationDate` string
      - `tokenDeactivationDate` string
      - `lastTokenStatusUpdatedTime` string
      - `originalToken` string
      - `originalTokenRequestorID` string
      - `originalTokenReferenceID` string
      - `originalTokenAssuranceLevel` string
      - `originalTokenAssuranceMethod` string
      - `tokenAssuranceMethod` string
      - `originalTokenType` string
      - `tokenRequestorName` string
      - `autoFillIndicator` boolean
    - `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
  - `tokenUserInfo` TokenUserInfo
    - `tokenUserId` string
    - `tokenUserAppType` string
  - `merchantInfo` MerchantInfo
    - `merchantId` string
    - `merchantName` string
  - `tokenInfo` TokenData
    - `token` string
    - `tokenType` 'SECURE_ELEMENT' | 'HCE' | 'CARD_ON_FILE' | 'ECOMMERCE' | 'QRC' | 'STATIC' | 'NA'
    - `tokenStatus` 'ACTIVE' | 'INACTIVE' | 'SUSPENDED' | 'DELETED' | 'DEACTIVATED' | 'CHECK_CONTEXT'
    - `sequenceNumber` string
    - `tokenExpiry` ExpirationDate
      - `month` string
      - `year` string
    - `tokenAssuranceLevel` string
    - `numberOfActiveTokensForPAN` integer
    - `numberOfInactiveTokensForPAN` integer
    - `numberOfSuspendedTokensForPAN` integer
    - `tokenActivationDate` string
    - `tokenDeactivationDate` string
    - `lastTokenStatusUpdatedTime` string
    - `originalToken` string
    - `originalTokenRequestorID` string
    - `originalTokenReferenceID` string
    - `originalTokenAssuranceLevel` string
    - `originalTokenAssuranceMethod` string
    - `tokenAssuranceMethod` string
    - `originalTokenType` string
    - `tokenRequestorName` string
    - `autoFillIndicator` boolean
  - `clientWalletAccountId` string

## Response `200`

Successful Response

- RequestActivationMethodsResponse
  - `responseId` string
  - `error` Error
    - `errorCode` string
    - `errorDescription` string
    - `details` Details
      - `location` string
      - `message` string
  - `errorCode` string
  - `responseCode` string
  - `activationMethods` AuthenticationMethod[]
    - `id` string
    - `type` string
    - `value` string
    - `sourceAddress` string
    - `otpMethodPlatform` 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/mada/issuerServices/1.0/requestActivationMethods/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)