---
title: "Notification"
method: POST
path: "/pws/mada/issuerServices/1.0/notification/"
tags: ["Mada Pay - MadaPay To PTY (Beta)"]
---

# Notification

`POST /pws/mada/issuerServices/1.0/notification/`

## Request

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

Notification

## Request body

- Notification
  - `requestId` string
  - `contentGroupId` string
  - `tspId` string
  - `messageReasonCode` 'TOKEN_CREATED' | 'NOTIFY_SERVICE_ACTIVATED' | 'DEVICE_PROVISIONING_RESULT' | 'DEVICE_PROVISIONING_REPERSONALIZATION_RESULT' | 'NOTIFY_TOKEN_UPDATED' | 'CALL_CENTER_ACTIVATION' | 'MOBILE_BANK_APP_ACTIVATION' | 'TOKEN_ACTIVATED' | 'ACTIVATION_INITIATED_BY_ISSUER' | 'ACTIVATION_INITIATED_BY_TSP' | 'LUK_REPLENISHMENT' | 'TOKEN_DEACTIVATED' | 'DELETION_INITIATED_BY_ISSUER' | 'DELETION_INITIATED_BY_TSP' | 'DELETION_INITIATED_BY_USER' | 'TOKEN_SUSPEND' | 'SUSPENSION_INITIATED_BY_ISSUER' | 'SUSPENSION_INITIATED_BY_TSP' | 'SUSPENSION_INITIATED_BY_USER' | 'TOKEN_RESUME' | 'RESUMPTION_INITIATED_BY_ISSUER' | 'RESUMPTION_INITIATED_BY_TSP' | 'RESUMPTION_INITIATED_BY_USER' | 'UPDATE_INITIATED_BY_ISSUER' | 'CARD_METADATA_UPDATED' | 'APPROVE_PROV_STIP' | 'TOKEN_DEVICE_BINDING_RESULT' | 'CARDHOLDER_STEPUP_RESULT' | 'TOKEN_EXPIRY_DATE_UPDATED' | 'TRUSTED_LISTING_ENROLLMENT_RESULT' | 'OTP_VERIFICATION_RESULT' | 'TOKEN_DEVICE_BINDING_REMOVED' | 'ACCOUNT_UPDATE' | 'EXP_DATE_UPDATE' | 'ACCOUNT_LEVEL_RECORD_UPDATE'
  - `messageReason` string
  - `context` NotificationContext
    - `actionCode` string
    - `eventId` string
    - `eventType` string
    - `dateTimeOfEvent` string
    - `tokenRequestorId` string
    - `tokenReferenceId` string
    - `panReferenceId` string
    - `issuerPanReferenceId` string
    - `taskId` string
    - `accountIdHash` string
    - `clientWalletAccountId` 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
    - `panSource` string
    - `addressVerificationResultCode` string
    - `cvv2ResultsCode` string
    - `consumerEntryMode` string
    - `consumerLanguage` string
    - `termsAndConditions` TermsAndConditions
      - `id` string
      - `status` boolean
      - `date` 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
    - `deviceId` string
    - `services` string[]
    - `correlationId` string
    - `walletId` string
    - `paymentAppInstanceId` string
    - `secureElementId` string
    - `accountPanSuffix` string
    - `serviceRequestDateTime` string
    - `productConfigurationId` string
    - `decision` string
    - `decisionMadeBy` string
    - `tokenActivatedDateTime` string
    - `numberOfActivationAttempts` string
    - `tokenStatus` string
    - `reasonCode` string
    - `suspendedBy` string[]
    - `tokenExpiry` ExpirationDate
      - `month` string
      - `year` string
    - `issuerId` string
    - `isEnrolmentFinish` string
    - `source` string
    - `cardStatusUpdateResult` string
    - `isPrimaryToken` string
    - `tokenUserInfo` TokenUserInfo
      - `tokenUserId` string
      - `tokenUserAppType` string
    - `merchantInfo` MerchantInfo
      - `merchantId` string
      - `merchantName` string
    - `cardHolderStepupResult` string
    - `deviceBindingResult` string
    - `trustedListingResult` string
    - `errorCode` string
    - `errorMessage` string
    - `tokenRequestorTspID` string
    - `locale` 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

## Response `200`

Successful Response

## 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/notification/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)