Tokenization notifications
Paymentology receives tokenization APIs from <<glossary:TSP>> as part of the provisioning of the cards to tokenization and token life cycle management that takes place after the tokenisation of the card.
The notifications are sent from Paymentology systems as a result of processing the API requests coming in from the Scheme/TSP/I-TSP for the clients to be aware of the activity happening. No response is required on these notifications from the client's systems. However, clients should take note of the additional messages to perform the necessary next steps in notifying their cardholders.
Message structure
The basic structure for the messages will be consistent across all messages, which will work as an envelope containing critical information and the desensitized original message.
| MESSAGE_TYPE | ||
|---|---|---|
Message_Type | Type of message e.g. TER, TAR, OTP etc. | |
Message_Desc | Description of the message type | |
Version | The version of the request payload. | |
| SUMMARY | ||
Api_Call_Unique_Identifier | Unique Identifier for each message | |
Token | Paymentology’s Card Token | |
Token_Status | Paymentology Card Token's status. | |
PID | Product ID of the card product | |
Client_Id | Client ID of the card | |
Source | Source of the message e.g. TSP or wallet provider's name | |
Network | Payment scheme used | |
Date_Time | Date and time stamp | |
Processor_Decision_Code | Processor decision in the API to the caller | |
Wallet | Name of the wallet used e.g. Apple, Google, Samsung etc. | |
Device | Name of the device used for token | |
OTP | One Time Passcode | |
Message_Reason | Additional information about the message | |
| ADDITIONAL_MESSAGE_DATA | {...} | Original Message from the sender e.g. MeaWallet._ May contain additional fields_ |
Notification message types
Tokenization eligibility request (TER)
Token eligibility request is an optional notification and is available based on the I-TSP used e.g. available in MeaWallet, that checks the eligibility of the card for tokenization.
{
"MESSAGE_TYPE": {
"Message_Type": "TER",
"Message_Desc": "Tokenization Eligibility Request",
"Version": "2"
},
"SUMMARY": {
"Api_Call_Unique_Identifier": "4344183551686052173893",
"Token": 881522077,
"Token_Status": 1000,
"PID": 123,
"Client_Id": 123456,
"Source": "MEA Wallet",
"Network": "MEA Wallet",
"Date_Time": "2023-10-16 09:42:19.002",
"Processor_Decision_Code": null,
"Wallet": null,
"Device": null,
"OTP": null,
"Message_Reason": "Check Card Eligibility",
"Token_Requestor_Id": null
},
"ADDITIONAL_MESSAGE_DATA": {
"Correlation_Id": "D0012345377845",
"Security_Code_Result": "NOT_PROCESSED",
"Wallet_Id": "321",
"Token_Unique_Reference": "DMEAMC000000003256517E6EF78ABDCB480ADE96B3870177"
}
}Tokenization authorization request (TAR)
This is the main notification when a tokenization request is made by a <<glossary:TSP>>, all the major TSP's make a tokenization authorization request to the issuer.
{
"MESSAGE_TYPE": {
"Message_Type": "TAR",
"Message_Desc": "Tokenization Authorization Request",
"Version": "2"
},
"SUMMARY": {
"Api_Call_Unique_Identifier": "3435676201697182787734",
"Token": 123456789,
"Token_Status": 1000,
"PID": 123,
"Client_Id": 123456,
"Source": "MADA",
"Network": "MADA",
"Date_Time": "2023-10-13 14:39:47.841",
"Processor_Decision_Code": "00",
"Wallet": "Mada",
"Device": "string",
"OTP": null,
"Message_Reason": "authorizeService",
"Token_Requestor_Id": "50123456059"
},
"ADDITIONAL_MESSAGE_DATA": {
"Locale": null,
"Request_Id": "7d681234-80e5-4c0f-905b-1234567a1263",
"Consumer_Entry_Mode": null,
"Mobile_Number_Suffix": null,
"Authentication_Value": null,
"Content_Group_Id": null,
"Payment_App_Instance_Id": "b57aa123-5b23-3dfa-bad2-dcc64e123456",
"Authentication_Value_Type": null,
"Wallet_Provider_Id": "456",
"Cvv2_Results_Code": null,
"Tsp_Id": "MDES",
"Issuer_Id": null,
"Address_Verification_Result_Code": null,
"Token_Reference_Id": null,
"Encrypted_Data": "eyJhbGciOiJSUzI1NiIsImtpZCI6ImhHhHhHd3NzLmtleSJ9.ZXlKaGJHHHHHHHpTVTBFeFh6VWJJJ0psYm1NaU9pSkJNVEk0UjBO78hfjudhtsgxrSWpvaVpETTJNhjfyhdisjaEyVjVJaXdpYVdGMElqb2lNVFk1TURJM01URXpORFEzTVNJc0luUjVjQ0k2SWtwUFUwVWlmUS5rRHVpc0ltUy1qQTNJTWR0c200RmNBY2tILW81RW43dkZqZXVkQjBCRUxOdW9wdmJFRzhYY2ljT2E5OU5mRmcwa3RPVlpwNi1xN3IwV1VxQ0VUamFhSFZER3JZbDc0ZHdOVVNpeV93TGx5VE9YTWpoTnBHMVpURElTelFyOEl5MjZKYnhhTHBMTTdiSUtYODZJQnVmUHZ0T01hUU9GRE85alRyODNGRDMzQnpkM2dEUHU2WGI2cWRpd3JhMlZ0QXloUGJrajRLMWliSmdEV2xkdzBQUjNNVVFWUkFBWlBmd2k4WVJkR25LNk5EeVVRM2UtNnhqVnh4R1FTVmtPZUZxSGtfMC1teU1qVHYxZGJOWGF2Q3U3Nk5BZUhYaVFsVkRmOUcxTGVRNThNNzBnNmpaYkhraElzM1dIdGFDZzI1Y3Z0YTNTa0NtVFRLWGdjMHlyTkNPRncuYzlYYTc5ZWpweEpHaXFhYy5CbDd0S3VwLVVaeW1HS3pEbS1ibTBoMGZteUhlWEdnWXJaZHBhVlBKaDc3YXlVN1lIYjRGdTVkV1ZONk9DUzNiN1dqSmxIVEVOYTVXTUZpcHVTSkM2REtBUDUyMjRVNzN4aUlSZ3huN1czc2xydE5qak1xYjRyU1ZBYW0tbE9lUGpTZTVFVm5aZGJwMzF0WFBnSU50N3hnWkFzZHFIcTJySEM0SjR0a2xhYmxWcWtTTHQ4U3RFTkVwSXJOYWlBRENZOTVlQVoxdlpsYzBJdE50RG8tNU10dXA3Q0EySWlHRGRTbm1DTmFRQm1sbUdxVGtwYnE2QzJKOERxVER6M0Mwc1dXbDZjS1hRVFpuWXN2Zmc1Zldlc2hjRjFsQzNLMW14UWt0aERnQWdxa0NuazhDaUxDQzFVdFVUZ2E1bjg3QkdDVFB5eEhMck5ub2k0a01zOE1PUEpsMVc0OXJUWWJHM1ZYQVIycm9kVEhueWRfTWZpYnd2RHZmbmIwNFR0RHQ2Ym1GWUg0RmYzWGVoc2VSOHNZTmV5ajZPekZtTGJ4YXRRNW9zMExxN1pBTU0zdFlPaFF6RFRkMWlkRnlITlN1cTVfUE13YjhwVW9aek9yaDZqcXUzSDVNQTA4WUE2bmNzYm9lMk5WZ1FzVVdPS0tybjM0dEszNS1hUTdjaU9pME0zR3h5cVBOWHdyQ0poeU4zOXB3MHdnT2FjWWh6OUpCRW1Ec0VmYkVFUVZyLVJpLTkzM1NsYnRsVWc2enh0Nng0U2lwYjRwOFJTR3psX3ZWaDhyS0xVd3NiTi1WZUdzNGpIcF9NS0JFODBEWjlmVkJDbVR5LXJMbG5PeHEtRTRxVUNYYkpnTnZkZ3VGdnZpOG12RE5RMWJhWnhsNEhyV1JqdzcydWI3dEo0VlJaa1d4R0lWQU9TMzRmQ3M2VTMydmp5TDhsdVVMWF9PbDZQd1FiRW9YQ3o1U1A0N19xTUxMZWg5aXlaQ2RPRVFTSUpoU0l1QU4xZXpFRzZXZzlYM3NlYXF3dTZ4bC15U2gyR3FaOXJNVlNxcndwR2t3V3B3M1BUSlMzdXpzUlFnOE5xMng1UE9tVFlxVjRjM2dFbWpfN2tQZ2hoT3lyVDUzcDVEYjgwaXBQRnhUTzFrakRSVUJQVXJuZGc1dGtqWGd5bWVOOEcxMnJ3NmhPRFExcGpRZURuVko0YklqNG5FWkpmaS1BNVYzU1c4SjAxUFQtdEtNbGI1elJmT0k2OFZQcjZzTk9yVFNUYzhCTVo5S3FQWjdKT1Nacm5hdHYzX1hrOFI3YXhwVFhMMGpFMXpWa3ViZkRwS2w0TkVGaVYyTWVqS09OUnBPWGZ3alVSYlhQcHA4YnczclRESTR1RzZKNG9RQWNocjFjQjVKZi1tbm1yS2NKdzgyd3pfaVlpaFZIRUxWUXdfMWVNYWcyakNxUm00VE1BTklqN1l4QWZJUnEtc2VuUlJRRVFDLUgwMDVaLXl2eFNWVUtHbVJjNEs4cnhIcFE0WmhBRnZTVnRxZ3daZS01bXM2bkF2MXhhcFc3NDdqTXBkRWN0UTgtNTVGRFRucWM1ekZhNmVUWVJMSDI0bkZuVmxXRTh1V1JIV2dnU19nQ2ljbElxNjVCbWFQaGJzYmFVc0hTdnZyZElFUGptWHRTLTdpeEZHekJRcEU4OFNxOVlQMnd6QjZWMVYyZjdvdXhEcHFGcE56SzNHUnFxd3Z0OWtzZ09JOG9uenhHUlNSOVdxWHVhRWJKb1NSWnpEbENfaGtXa05kSHNnQnZvMzdwMWtFZE1kdHc4ME1OOWtwREJnZDhNaE1fRHRhcTNFeUJNb2dSajZrVnZibEVrbXZZOGQxUWpIQTJJNzBvcWhEd1VzRUd4Y0VYZlRsSFVBa20xUmFwUURLMVV4V3JfblFYdkpXU2F3aTdXbjhacjNOWFF5QktLVDFocVp5SlpKNXdDUmZURTRVX1ZsalBidjhRYWxRenU0MmpvQ1Jqend2ekZBQWlnaUs3ejhNS0V3ZEtrb2pfQXVQYnBuQlZ0RmZtRk9QejF2Qzlkc1lIYmRtMGNsRTBFa3pTdG9qQnVRT1EwbjBBbzI1Tkx5MjRfRUdTRlFwZ2xyN01kUmdoRldCVWQyTUV2bkg3eWlsODlqaXpmVUx0MC0zNEh1QkRnY0s4dVkxV3I0MkdIZVFETWpuSWhQOFVHMDhQMEV0cHZSV09xdFdrLUdvZXZhOHZtX0tDYlFacXVTR3RnMGpRR2lzZGZIeFgyc3VuZUloMUtfYThHc01QaHJtYmo5RjV0ZGJsdlJfaFNueGZ6ekxuWmFyYy1vT3Zoc2ZBaU9BV0RqdU9HcEZBS0o2UlJhZ1gyR0ZDSmVBX0ZuNUNlVnBRWVFmSUkxQU1EUU1jVWxUQTNGcGIybnVyMXRpMGtiNFQ5cGNjQ1hjMzJwaTZDU0xIa3E1ZVpYMlp6MWNmSFZCMS00b3FmSm9TV0dRTTBOV0JpSm9wMndadW9DZ0hTZFQxeXdkdlNqMHozdGpiX0tfYnlnX24tdnhSdVBkWmZVWG90WHhDckxLSHVvbGVxUFBrXzZGWEFnb2xGQncteEFxTEt4RFRnN25NRGlXb1BfQVFFLV9NZVg0ekVTeG1YcVJ1ZzgxaVhpbHhPaldodmx3R1lNQXlIU3JiVmxRWFBIQ1JJN0VLSFMwSWh6NXpJMkt4R1ljbzhTV0FNc25pOFg1M0RCeWl1RzQ1aVZidmN5bzMtMXNWSElMSHNsdzJfWkYybXlfMmhRWk9aVVc0elRRWUh6SVlRZnBjTEVCb0xVWWdiM2tDUmstd3AxWnlKNFlVWXhnTUc1cWZIWXRlZlEyQ1FuWU9tR0Nxa29fYUx3NUZmcXVRd1YxQ0tSVE5sRU1Cd1JQR0s4aEs3NmNyaU9wZkJWakRTQnFaRF9sRVNQZUJ2MjJNajc2RkpnWWxXOVQzWnlkNXVGcGUwMXhhUjhFdEFMZlQ3MkphaERlc2FKNDBHMUhHUXJiLTdpUTcyRDF3WXBJeHVWRGFtaEdkc0tVUnVUUkt0SjVlQVJ6MC10ZjVZc19mdjFFN2VUVnZ0Z211ZThCbVRYUFVSM2hmcVA0OXg1ZURzTF9wekEwc3FmUEdFeFZuaUhoRVc1clhmMi1lNjVoUlRKMDJwdW93VG03ZGh1R3dnajgtaVFnMEk2ZUR0NncwRkJvRVhydENBTnJYWjM3R1J2TWZudW91MHdDaHU3QmdTTDFxNUp1LVNIVXJzZ3VQbXJvLVF5SDc1MFZCQkxRWHZKTDljWFlLYTBtN3NhMjRFQ01aZXIwWkstZnBIeWt0MWg5X2taSVpaZVNNcW5DRjg4Z1A3bWYzWVZYMnIxLW5pb0lLazUzMm5mQzZjSHlQQ2l5eWNRVU8xZkwuQ0tndHllcVVEQVlJTkZWY29FZEVQQQ.U88pzSBliav2_cZB0_VYfxk1MCCTSyqDmdlMTyaTL-Y-2u39rpvHlFRbTb9Yu7bMNqfCI-HvVrBVhYIIyxWXfYoMjrzorkPzKDQR99RE0VrKm7IeX6uuctGuTgQ8GlkLdUY-IWVRcJT-6ZfKfqkJaHmOMZrD3Jy-JW4S2Yp71IPTJSLlnsJxITtpotLeiuOgt59dWjy02suHsD5ktypawUmHQFTJnHdJ9X8-WgAyy_JhFGnpL23iAAfSvSyZc9qSN1WMYykM_n0pJifzRGsn_cqcdhznLHtz9ksDJjuvCyDt9uyXFVqG0QlV_pJH5TJfjq0stpnA2Ddi0VER6GanOQ",
"Device_Info": {
"Device_Bluetooth_Mac": null,
"Form_Factor": "PHONE",
"Imei": null,
"Time_Zone": null,
"Device_Model": null,
"Device_Manufacturer": null,
"Four_Last_Digit_Phone_Number": null,
"Msisdn": null,
"Device_Id": null,
"Serial_Number": null,
"Os_Version": "13",
"Time_Zone_Settings": null,
"Token_Protection_Method": null,
"Device_IP_Address_V4": null,
"Payment_Types": [
"NFC",
"DSRP"
],
"Device_Brand": null,
"Os_Build_Id": null,
"Os_Name": "ANDROID",
"Device_Name": "string",
"Device_Language_Code": null,
"Storage_Technology": "DEVICE_MEMORY",
"Location_Source": null,
"Iso_Device_Type": "21",
"Device_Location": null,
"Device_Number": null,
"Device_Index": "0"
},
"Pan_Reference_Id": null,
"Issuer_Pan_Reference_Id": null,
"Key_Values": null,
"Correlation_Id": "D9876543213590",
"Services": [
"DIGITIZATION"
],
"Pan_Source": "MANUAL",
"Client_Wallet_Account_Id": "b45aa123-5b23-3dfa-hhl2-dcc64e543211",
"Token_Requestor_Id": "50123456059",
"Account_Id_Hash": null,
"Terms_And_Conditions": null,
"Token_Info": {
"Number_Of_Inactive_Tokens_For_PAN": 0,
"Token_Deactivation_Date": null,
"Number_Of_Suspended_Tokens_For_PAN": 0,
"Original_Token_Assurance_Level": null,
"Token_Activation_Date": null,
"Sequence_Number": null,
"Token": null,
"Number_Of_Active_Tokens_For_PAN": 0,
"Original_Token_Requestor_ID": null,
"Token_Type": "HCE",
"Token_Assurance_Level": null,
"Last_Token_Status_Updated_Time": null,
"Token_Status": null,
"Original_Token_Reference_ID": null,
"Token_Expiry": null,
"Original_Token": null
}
}
}{
"MESSAGE_TYPE": {
"Message_Type": "TAR",
"Message_Desc": "Tokenization Authorization Request",
"Version": "1"
},
"SUMMARY": {
"Api_Call_Unique_Identifier": "1217279201746513104525",
"Token": 181259646,
"Token_Status": 1000,
"PID": 319,
"Client_Id": 123456,
"Source": "MADA",
"Network": "MADA",
"Date_Time": "2025-05-06 13:31:52.245",
"Processor_Decision_Code": "00",
"Wallet": "Mada",
"Device": "UjJGc1lYaDVJRTV2ZEdVeU1DQTFSdy4u",
"OTP": null,
"Message_Reason": "authorizeService"
},
"ADDITIONAL_MESSAGE_DATA": {
"requestId": "c46bc347-7a39-434e-8664-ad7f14535a08",
"contentGroupId": null,
"tspId": "VTS",
"issuerId": null,
"correlationId": "303215247919126",
"tokenRequestorId": "40010030621",
"tokenReferenceId": "DNITHE302321524791911111",
"issuerPanReferenceId": null,
"encryptedData": "encryptedData",
"decryptedData": {
"cardInfoData": {
"accountNumber": "REDACTED",
"expirationDate": {
"month": "REDACTED",
"year": "REDACTED"
},
"billingAddress": {
"line1": null,
"line2": null,
"city": null,
"state": null,
"country": null,
"postalCode": null,
"countrySubdivision": null,
"keyValues": null
},
"riskAssessmentScore": "18"
},
"riskInformation": {
"riskAssessmentScore": "18",
"walletProviderReasonCodes": [
null
],
"deviceInfo": {
"deviceIndex": "0"
},
"visaTokenScore": "04",
"visaTokenDecisioning": "00"
}
},
"termsAndConditions": null,
"panReferenceId": "V-3023197483302244500000",
"walletProviderId": "1312724516",
"services": null,
"paymentAppInstanceId": "1312724516",
"accountIdHash": "78873B3DF1ACB570DBA46281EFCB2E8AADFC5F0A197B30CA797F6CD9CFE00000",
"mobileNumberSuffix": null,
"deviceInfo": {
"deviceId": "5aa65c0481c58e7c84b00000",
"deviceLanguageCode": "eng",
"deviceName": "UjJGc1lYaDVJRTV2ZEdVeU1DQTF00000",
"deviceManufacturer": "samsung",
"deviceBrand": "samsung",
"deviceModel": "samsung",
"formFactor": "MOBILEPHONE_OR_TABLET",
"osName": "ANDROID",
"osVersion": "11",
"osBuildId": "RP1A.200720.012",
"deviceIPAddressV4": "10.0.0.1",
"locationSource": "CELLULAR",
"tokenProtectionMethod": "SOFTWARE",
"deviceIndex": "0",
"originalDeviceId": "testing",
"originalDeviceType": "testing",
"deviceIdType": "testing",
"osId": "testing",
"simSerialNumber": "testing",
"deviceLostMode": "testing",
"deviceBindingStatus": "testing"
},
"authenticationValue": null,
"authenticationValueType": null,
"keyValues": null,
"tokenInfo": {
"token": "testing",
"tokenType": "HCE",
"tokenStatus": null,
"sequenceNumber": null,
"tokenExpiry": {
"month": "02",
"year": "30"
},
"tokenAssuranceLevel": null,
"numberOfActiveTokensForPAN": 0,
"numberOfInactiveTokensForPAN": 0,
"numberOfSuspendedTokensForPAN": 0,
"tokenActivationDate": null,
"tokenDeactivationDate": null,
"lastTokenStatusUpdatedTime": null,
"originalToken": null,
"originalTokenRequestorID": null,
"originalTokenReferenceID": null,
"originalTokenAssuranceLevel": "1",
"originalTokenAssuranceMethod": "1",
"tokenAssuranceMethod": "1",
"originalTokenType": "1",
"tokenRequestorName": "testing",
"autoFillIndicator": false
},
"clientWalletAccountId": "1312724516",
"panSource": "MANUAL",
"addressVerificationResultCode": null,
"cvv2ResultsCode": null,
"consumerEntryMode": null,
"locale": null,
"tokenRequestorTspID": "testing"
}
}Retrieve contact data request (RCD)
This is used to notify the client. Cardholder contact data is sent to I-TSP during RCD.
{
"MESSAGE_TYPE": {
"Message_Type": "RCD",
"Message_Desc": "Retrieve Contact Data Request",
"Version": "2"
},
"SUMMARY": {
"Api_Call_Unique_Identifier": "17764328765432124316133",
"Token": 123456789,
"Token_Status": 1000,
"PID": 123,
"Client_Id": 123456,
"Source": "MEA Wallet",
"Network": "MEA Wallet",
"Date_Time": "2023-10-16 09:45:16.150",
"Processor_Decision_Code": null,
"Wallet": null,
"Device": null,
"OTP": null,
"Message_Reason": "Retrieve Contact Data",
"Token_Requestor_Id": null
},
"ADDITIONAL_MESSAGE_DATA": {
"Correlation_Id": "D9876543213590",
"Token_Unique_Reference": "DM4MMC8787878987d457775b729b498765432616e1500000",
"Reason_Code": "PROVISIONING"
}
}Tokenization activation code request
This is part of the flow when a step-up happens, and additional verification is required as part of the tokenization provisioning request. One-time passcodes (OTP) are sent as part of this message to the clients so they can forward them to the cardholders.
{
"MESSAGE_TYPE": {
"Message_Type": "OTP",
"Message_Desc": "Tokenization Activation Code Request",
"Version": "2"
},
"SUMMARY": {
"Api_Call_Unique_Identifier": "19815299061675824285274",
"Token": 881522077,
"Token_Status": 1000,
"PID": 7,
"Client_Id": 123456,
"Source": "MEA Wallet",
"Network": "MEA Wallet",
"Date_Time": "2024-11-15 11:22:17.984",
"Processor_Decision_Code": null,
"Wallet": "Apple",
"Device": null,
"OTP": "123321",
"Message_Reason": "Send Passcode",
"Token_Requestor_Id": "90876543210"
},
"ADDITIONAL_MESSAGE_DATA": {
"Correlation_Id": "12345678098765432104",
"Passcode_Delivery_Method_Value": "123321",
"Passcode": "123321",
"Token_Unique_Reference": "DWSPMC000000000132d72d4fcb2f4136a0532d3093ff1a45",
"Passcode_Delivery_Method_Type": "SMS_OTP",
"Token_Requestor_Id": "90876543210",
"Reason_Code": "PROVISIONING"
}
}Activation methods request (AMR)
Activation methods are requested as part of the step-up verification process to activate the tokens that are generated during the tokenization process. Activation methods include, Call Center, Email, SMS, call etc.
{
"MESSAGE_TYPE": {
"Message_Type": "AMR",
"Message_Desc": "Activation Methods Request",
"Version": "2"
},
"SUMMARY": {
"Api_Call_Unique_Identifier": "14120987654876504073477",
"Token": 198765432,
"Token_Status": 1000,
"PID": 123,
"Client_Id": 123456,
"Source": "MADA",
"Network": "MADA",
"Date_Time": "2023-10-13 21:04:55.176",
"Processor_Decision_Code": "00",
"Wallet": "Apple",
"Device": "",
"OTP": null,
"Message_Reason": "requestActivationMethods",
"Token_Requestor_Id": "12348765543"
},
"ADDITIONAL_MESSAGE_DATA": {
"Request_Id": "7d681234-80e5-4c0f-905b-1234567a1263",
"Token_Reference_Id": "DNITHE98765432102900000",
"Encrypted_Data": "eyJhbGciOiJSUzI1NiIsImtpZCI6ImhHhHhHd3NzLmtleSJ9.ZXlKaGJHHHHHHHpTVTBFeFh6VWJJJ0psYm1NaU9pSkJNVEk0UjBO78hfjudhtsgxrSWpvaVpETTJNhjfyhdisjaEyVjVJaXdpYVdGMElqb2lNVFk1TURJM01URXpORFEzTVNJc0luUjVjQ0k2SWtwUFUwVWlmUS5rRHVpc0ltUy1qQTNJTWR0c200RmNBY2tILW81RW43dkZqZXVkQjBCRUxOdW9wdmJFRzhYY2ljT2E5OU5mRmcwa3RPVlpwNi1xN3IwV1VxQ0VUamFhSFZER3JZbDc0ZHdOVVNpeV93TGx5VE9YTWpoTnBHMVpURElTelFyOEl5MjZKYnhhTHBMTTdiSUtYODZJQnVmUHZ0T01hUU9GRE85alRyODNGRDMzQnpkM2dEUHU2WGI2cWRpd3JhMlZ0QXloUGJrajRLMWliSmdEV2xkdzBQUjNNVVFWUkFBWlBmd2k4WVJkR25LNk5EeVVRM2UtNnhqVnh4R1FTVmtPZUZxSGtfMC1teU1qVHYxZGJOWGF2Q3U3Nk5BZUhYaVFsVkRmOUcxTGVRNThNNzBnNmpaYkhraElzM1dIdGFDZzI1Y3Z0YTNTa0NtVFRLWGdjMHlyTkNPRncuYzlYYTc5ZWpweEpHaXFhYy5CbDd0S3VwLVVaeW1HS3pEbS1ibTBoMGZteUhlWEdnWXJaZHBhVlBKaDc3YXlVN1lIYjRGdTVkV1ZONk9DUzNiN1dqSmxIVEVOYTVXTUZpcHVTSkM2REtBUDUyMjRVNzN4aUlSZ3huN1czc2xydE5qak1xYjRyU1ZBYW0tbE9lUGpTZTVFVm5aZGJwMzF0WFBnSU50N3hnWkFzZHFIcTJySEM0SjR0a2xhYmxWcWtTTHQ4U3RFTkVwSXJOYWlBRENZOTVlQVoxdlpsYzBJdE50RG8tNU10dXA3Q0EySWlHRGRTbm1DTmFRQm1sbUdxVGtwYnE2QzJKOERxVER6M0Mwc1dXbDZjS1hRVFpuWXN2Zmc1Zldlc2hjRjFsQzNLMW14UWt0aERnQWdxa0NuazhDaUxDQzFVdFVUZ2E1bjg3QkdDVFB5eEhMck5ub2k0a01zOE1PUEpsMVc0OXJUWWJHM1ZYQVIycm9kVEhueWRfTWZpYnd2RHZmbmIwNFR0RHQ2Ym1GWUg0RmYzWGVoc2VSOHNZTmV5ajZPekZtTGJ4YXRRNW9zMExxN1pBTU0zdFlPaFF6RFRkMWlkRnlITlN1cTVfUE13YjhwVW9aek9yaDZqcXUzSDVNQTA4WUE2bmNzYm9lMk5WZ1FzVVdPS0tybjM0dEszNS1hUTdjaU9pME0zR3h5cVBOWHdyQ0poeU4zOXB3MHdnT2FjWWh6OUpCRW1Ec0VmYkVFUVZyLVJpLTkzM1NsYnRsVWc2enh0Nng0U2lwYjRwOFJTR3psX3ZWaDhyS0xVd3NiTi1WZUdzNGpIcF9NS0JFODBEWjlmVkJDbVR5LXJMbG5PeHEtRTRxVUNYYkpnTnZkZ3VGdnZpOG12RE5RMWJhWnhsNEhyV1JqdzcydWI3dEo0VlJaa1d4R0lWQU9TMzRmQ3M2VTMydmp5TDhsdVVMWF9PbDZQd1FiRW9YQ3o1U1A0N19xTUxMZWg5aXlaQ2RPRVFTSUpoU0l1QU4xZXpFRzZXZzlYM3NlYXF3dTZ4bC15U2gyR3FaOXJNVlNxcndwR2t3V3B3M1BUSlMzdXpzUlFnOE5xMng1UE9tVFlxVjRjM2dFbWpfN2tQZ2hoT3lyVDUzcDVEYjgwaXBQRnhUTzFrakRSVUJQVXJuZGc1dGtqWGd5bWVOOEcxMnJ3NmhPRFExcGpRZURuVko0YklqNG5FWkpmaS1BNVYzU1c4SjAxUFQtdEtNbGI1elJmT0k2OFZQcjZzTk9yVFNUYzhCTVo5S3FQWjdKT1Nacm5hdHYzX1hrOFI3YXhwVFhMMGpFMXpWa3ViZkRwS2w0TkVGaVYyTWVqS09OUnBPWGZ3alVSYlhQcHA4YnczclRESTR1RzZKNG9RQWNocjFjQjVKZi1tbm1yS2NKdzgyd3pfaVlpaFZIRUxWUXdfMWVNYWcyakNxUm00VE1BTklqN1l4QWZJUnEtc2VuUlJRRVFDLUgwMDVaLXl2eFNWVUtHbVJjNEs4cnhIcFE0WmhBRnZTVnRxZ3daZS01bXM2bkF2MXhhcFc3NDdqTXBkRWN0UTgtNTVGRFRucWM1ekZhNmVUWVJMSDI0bkZuVmxXRTh1V1JIV2dnU19nQ2ljbElxNjVCbWFQaGJzYmFVc0hTdnZyZElFUGptWHRTLTdpeEZHekJRcEU4OFNxOVlQMnd6QjZWMVYyZjdvdXhEcHFGcE56SzNHUnFxd3Z0OWtzZ09JOG9uenhHUlNSOVdxWHVhRWJKb1NSWnpEbENfaGtXa05kSHNnQnZvMzdwMWtFZE1kdHc4ME1OOWtwREJnZDhNaE1fRHRhcTNFeUJNb2dSajZrVnZibEVrbXZZOGQxUWpIQTJJNzBvcWhEd1VzRUd4Y0VYZlRsSFVBa20xUmFwUURLMVV4V3JfblFYdkpXU2F3aTdXbjhacjNOWFF5QktLVDFocVp5SlpKNXdDUmZURTRVX1ZsalBidjhRYWxRenU0MmpvQ1Jqend2ekZBQWlnaUs3ejhNS0V3ZEtrb2pfQXVQYnBuQlZ0RmZtRk9QejF2Qzlkc1lIYmRtMGNsRTBFa3pTdG9qQnVRT1EwbjBBbzI1Tkx5MjRfRUdTRlFwZ2xyN01kUmdoRldCVWQyTUV2bkg3eWlsODlqaXpmVUx0MC0zNEh1QkRnY0s4dVkxV3I0MkdIZVFETWpuSWhQOFVHMDhQMEV0cHZSV09xdFdrLUdvZXZhOHZtX0tDYlFacXVTR3RnMGpRR2lzZGZIeFgyc3VuZUloMUtfYThHc01QaHJtYmo5RjV0ZGJsdlJfaFNueGZ6ekxuWmFyYy1vT3Zoc2ZBaU9BV0RqdU9HcEZBS0o2UlJhZ1gyR0ZDSmVBX0ZuNUNlVnBRWVFmSUkxQU1EUU1jVWxUQTNGcGIybnVyMXRpMGtiNFQ5cGNjQ1hjMzJwaTZDU0xIa3E1ZVpYMlp6MWNmSFZCMS00b3FmSm9TV0dRTTBOV0JpSm9wMndadW9DZ0hTZFQxeXdkdlNqMHozdGpiX0tfYnlnX24tdnhSdVBkWmZVWG90WHhDckxLSHVvbGVxUFBrXzZGWEFnb2xGQncteEFxTEt4RFRnN25NRGlXb1BfQVFFLV9NZVg0ekVTeG1YcVJ1ZzgxaVhpbHhPaldodmx3R1lNQXlIU3JiVmxRWFBIQ1JJN0VLSFMwSWh6NXpJMkt4R1ljbzhTV0FNc25pOFg1M0RCeWl1RzQ1aVZidmN5bzMtMXNWSElMSHNsdzJfWkYybXlfMmhRWk9aVVc0elRRWUh6SVlRZnBjTEVCb0xVWWdiM2tDUmstd3AxWnlKNFlVWXhnTUc1cWZIWXRlZlEyQ1FuWU9tR0Nxa29fYUx3NUZmcXVRd1YxQ0tSVE5sRU1Cd1JQR0s4aEs3NmNyaU9wZkJWakRTQnFaRF9sRVNQZUJ2MjJNajc2RkpnWWxXOVQzWnlkNXVGcGUwMXhhUjhFdEFMZlQ3MkphaERlc2FKNDBHMUhHUXJiLTdpUTcyRDF3WXBJeHVWRGFtaEdkc0tVUnVUUkt0SjVlQVJ6MC10ZjVZc19mdjFFN2VUVnZ0Z211ZThCbVRYUFVSM2hmcVA0OXg1ZURzTF9wekEwc3FmUEdFeFZuaUhoRVc1clhmMi1lNjVoUlRKMDJwdW93VG03ZGh1R3dnajgtaVFnMEk2ZUR0NncwRkJvRVhydENBTnJYWjM3R1J2TWZudW91MHdDaHU3QmdTTDFxNUp1LVNIVXJzZ3VQbXJvLVF5SDc1MFZCQkxRWHZKTDljWFlLYTBtN3NhMjRFQ01aZXIwWkstZnBIeWt0MWg5X2taSVpaZVNNcW5DRjg4Z1A3bWYzWVZYMnIxLW5pb0lLazUzMm5mQzZjSHlQQ2l5eWNRVU8xZkwuQ0tndHllcVVEQVlJTkZWY29FZEVQQQ.U88pzSBliav2_cZB0_VYfxk1MCCTSyqDmdlMTyaTL-Y-2u39rpvHlFRbTb9Yu7bMNqfCI-HvVrBVhYIIyxWXfYoMjrzorkPzKDQR99RE0VrKm7IeX6uuctGuTgQ8GlkLdUY-IWVRcJT-6ZfKfqkJaHmOMZrD3Jy-JW4S2Yp71IPTJSLlnsJxITtpotLeiuOgt59dWjy02suHsD5ktypawUmHQFTJnHdJ9X8-WgAyy_JhFGnpL23iAAfSvSyZc9qSN1WMYykM_n0pJifzRGsn_cqcdhznLHtz9ksDJjuvCyDt9uyXFVqG0QlV_pJH5TJfjq0stpnA2Ddi0VER6GanOQ",
"Mobile_Number_Suffix": null,
"Device_Info": {
"Device_Bluetooth_Mac": null,
"Form_Factor": "MOBILE_PHONE",
"Imei": null,
"Time_Zone": null,
"Device_Model": null,
"Device_Manufacturer": null,
"Four_Last_Digit_Phone_Number": null,
"Msisdn": null,
"Device_Id": "042E3CA39A5A99887766550099887765A7899B915D500A19",
"Serial_Number": null,
"Os_Version": null,
"Time_Zone_Settings": null,
"Token_Protection_Method": null,
"Device_IP_Address_V4": null,
"Payment_Types": null,
"Device_Brand": null,
"Os_Build_Id": null,
"Os_Name": null,
"Device_Name": null,
"Device_Language_Code": null,
"Storage_Technology": null,
"Location_Source": null,
"Iso_Device_Type": null,
"Device_Location": null,
"Device_Number": "998765432103",
"Device_Index": "0"
},
"Pan_Reference_Id": "V-3023256748765432123000",
"Content_Group_Id": null,
"Correlation_Id": "D9876543213590",
"Payment_App_Instance_Id": "F3H7J8K97G6F53B5FHJKLKJEDFC4DA5A",
"Token_Type": null,
"Otp_Max_Reached": "false",
"Services": null,
"Wallet_Provider_Id": null,
"Otp_Reason": "PROVISIONING",
"Pan_Source": "MANUAL",
"Tsp_Id": "VTS",
"Client_Wallet_Account_Id": "F3H7J8K97G6F53B5FHJKLKJEDFC4DA5A",
"Token_User_Info": null,
"Token_Requestor_Id": "12348765543",
"Account_Id_Hash": null,
"Merchant_Info": null
}
}Device token binding request (DTB)
Device token binding is scheme specific notification e.g. VTS supports device binding to a specific token. Notifications are generated when such an event occurs on a tokenized card.
{
"MESSAGE_TYPE": {
"Message_Type": "DTB",
"Message_Desc": "Device Token Binding Request"
},
"SUMMARY": {
"api_call_unique_identifier": "100080012345100012",
"Token": "123456789",
"Token_Status": "string",
"PID": "10",
"Client_Id": "123457",
"Source": "MADA",
"Network": "VISA",
"Date_Time": "28-09-2020 17:44:32",
"Processor_Decision_Code": "00",
"Wallet": "string",
"Device": "string",
"OTP": "string",
"Message_Reason": "string"
},
"ADDITIONAL_MESSAGE_DATA"{
"data from the original message based on the source"
}
}Tokenization notification request (TNR)
Any changes to the token or card status results in notifications about the tokenization; these notifications are useful to update cardholders on token events. Currently, we receive 13 different notifications from the networks.
The data within the ADDITIONAL_MESSAGE_DATA object of the request is variable and differs per network. This is expected to be used for informational purposes, as we forward the received scheme data to you.
1. CREATED
Note how this notification contains risk data
{
"SUMMARY": {
"Processor_Decision_Code": null,
"Wallet": null,
"Client_Id": 123456,
"Date_Time": "2023-02-08 09:52:23.845",
"Token_Status": 1000,
"Api_Call_Unique_Identifier": "15118955031675824736543",
"OTP": 123456,
"Source": "MEA Wallet",
"Device": null,
"Network": "VISA",
"Token": 100046490,
"PID": 7,
"Message_Reason": "Token Notification: CREATED"
},
"MESSAGE_TYPE": {
"Message_Type": "TNR",
"Message_Desc": "Tokenization Notification Request",
"Version": "1"
},
"ADDITIONAL_MESSAGE_DATA": {
"paymentNetwork": "VISA",
"reasonCode": "CREATED",
"tokenUniqueReference": "DMEAMC000000003256CEB30FB095FEDD20C2AD03D2DB5FA3",
"panUniqueReference": "FWSPMC000000000159f71f703d2141efaf04dd26803f922b",
"paymentAccountReference": "5001a9f027e5629d11e3949a0800a",
"tokenRequestorId": "90876543210",
"walletId": "123",
"paymentAppInstanceId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e",
"tokenType": "EMBEDDED_SE",
"tokenState": "INACTIVE",
"secureElementId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e93452c",
"digitizationRequestTime": "2018-07-04T12:09:57.123+02:00",
"PANChecksum": "7a51d064a1a216a692f753fcdab276e4ff201a01d8b66f56d50d4d719fd0dc87",
"securityCodeValidatedBy": "NETWORK",
"provisioningDecision": "APPROVED",
"decisionReason": "WALLET_RECOMMENDS_HIGH_RISK",
"decisionMadeBy": "RULE_ENGINE",
"cardInfo": {
"source": "CARD_ADDED_MANUALLY"
},
"eventOriginatorName": "ISSUER",
"deviceInfo": {
"deviceID": "ehoqgncrksfrconzqirhsxfeefqgmafkorqzlyufuyccrqwy",
"deviceIndex": 1,
"serialNumber": "2F6D63",
"formFactor": "PHONE",
"isoDeviceType": "09",
"osName": "IOS",
"osVersion": "4.4",
"imei": "352099001761481",
"msisdn": "7307406945",
"paymentTypes": [
"NFC",
"DSRP"
],
"storageTechnology": "SE",
"cardCaptureTechnology": "CAMERA"
},
"riskData": {
"walletRecommendedDecision": "REQUIRE_ADDITIONAL_AUTHENTICATION",
"walletRecommendationStandardVersion": "1.0.0",
"tspRecommendedDecision": "REQUIRE_ADDITIONAL_AUTHENTICATION",
"tspRecommendationStandardVersion": "99",
"deviceScore": "3",
"accountScore": "5",
"phoneNumberScore": "1",
"recommendationReasons": [
"ACCOUNT_TOO_NEW",
"ACCOUNT_CARD_TOO_NEW",
"LOW_DEVICE_SCORE"
],
"accountIdHash": "5ae9c9890b326bd23bfa9db9672298ae3b10a9388e56ec17a001e191f24572aa",
"mobileNumberSuffix": "1234",
"activeTokenCount": "3",
"originalTokenAssuranceLevel": "1",
"tokenAssuranceMethod": "00",
"tokenAssuranceLevel": "1"
}
}
}2. ACTIVATED
{
"MESSAGE_TYPE": {
"Message_Type": "TNR",
"Message_Desc": "Tokenization Notification Request",
"Version": "2"
},
"SUMMARY": {
"Api_Call_Unique_Identifier": "9062398765430989934271",
"Token": 187654321,
"Token_Status": 1000,
"PID": 123,
"Client_Id": 123456,
"Source": "MEA Wallet",
"Network": "MASTERCARD",
"Date_Time": "2023-10-16 11:18:54.289",
"Processor_Decision_Code": "00",
"Wallet": "Apple",
"Device": "O Mobile",
"OTP": null,
"Message_Reason": "Token Notification: ACTIVATED",
"Token_Requestor_Id": "12348765543"
},
"ADDITIONAL_MESSAGE_DATA": {
"Payment_Account_Reference": "5001WERTYU11YZ4HJKLGH4SFV1C1T",
"Wallet_Id": "123",
"Token_Unique_Reference": "DAPLMC0076543210dc5a6ed2134a4d123456e12345e00000",
"Provisioning_Decision": "APPROVED",
"Pan_Unique_Reference": "FAPLMC0000789098d77885af67856a3281d123456fe00000",
"Device_Info": {
"Device_Name": "O Mobile",
"Payment_Types": [
"NFC",
"DSRP"
],
"Storage_Technology": "SE",
"Form_Factor": "PHONE",
"Iso_Device_Type": "21"
},
"Secure_Element_Id": "F3H7J8K97G6F53B5FHJKLKJEDFC4DA5A",
"Decision_Made_By": "RULE_ENGINE",
"Token_State": "ACTIVE",
"Token_Activation_Time": "2023-10-16T04:03:31Z",
"Payment_App_Instance_Id": "F3H7J8K97G6F53B5FHJKLKJEDFC4DA5A",
"Token_Type": "EMBEDDED_SE",
"Payment_Network": "MASTERCARD",
"Token_Requestor_Id": "12348765543",
"Reason_Code": "ACTIVATED",
"Risk_Data": {
"Mobile_Number_Suffix": "2323",
"Account_Id_Hash": "b0d7a0fb570edd332286b2ccHFJ7874635JF847DHJ47afc8aa993c827fb055a6",
"Active_Token_Count": "2"
}
}
}{
"MESSAGE_TYPE": {
"Message_Type": "TNR",
"Message_Desc": "Tokenization Notification Request",
"Version": "1"
},
"SUMMARY": {
"Api_Call_Unique_Identifier": "befb1be8-ed29-4233-b63a-bcd08847e8e0",
"Token": 181259646,
"Token_Status": 1000,
"PID": 319,
"Client_Id": 123456,
"Source": "MADA",
"Network": "MADA_CO",
"Date_Time": "2025-05-06 13:44:22.066",
"Processor_Decision_Code": "00",
"Wallet": null,
"Device": null,
"OTP": null,
"Message_Reason": "NOTIFY_SERVICE_ACTIVATED"
},
"ADDITIONAL_MESSAGE_DATA": {
"requestId": "befb1be8-ed29-4233-b63a-bcd08847e8e0",
"contentGroupId": null,
"tspId": "MADA_CO",
"messageReasonCode": "NOTIFY_SERVICE_ACTIVATED",
"messageReason": null,
"context": {
"actionCode": null,
"eventId": null,
"eventType": null,
"dateTimeOfEvent": "1739861453000",
"tokenRequestorId": "37800010202",
"tokenReferenceId": "abcdefg",
"panReferenceId": "abcdefg",
"issuerPanReferenceId": null,
"taskId": null,
"accountIdHash": null,
"clientWalletAccountId": null,
"encryptedData": "encryptedData",
"decryptedData": {
"cardInfoData": {
"accountNumber": "REDACTED",
"paymentAccountReference": "abcd",
"accountHolderData": {
"emailAddress": "[email protected]",
"countryDialInCode": "123",
"phoneNumber": "123456"
}
},
"tokenData": {
"token": "REDACTED",
"tokenType": "SECURE_ELEMENT",
"tokenStatus": "ACTIVE",
"sequenceNumber": null,
"tokenExpiry": {
"month": "REDACTED",
"year": "REDACTED"
},
"tokenAssuranceLevel": null,
"numberOfActiveTokensForPAN": 0,
"numberOfInactiveTokensForPAN": 0,
"numberOfSuspendedTokensForPAN": 0,
"tokenActivationDate": null,
"tokenDeactivationDate": null,
"lastTokenStatusUpdatedTime": null,
"originalToken": null,
"originalTokenRequestorID": null,
"originalTokenReferenceID": null,
"originalTokenAssuranceLevel": null,
"originalTokenAssuranceMethod": null,
"tokenAssuranceMethod": "11",
"originalTokenType": null,
"tokenRequestorName": null,
"autoFillIndicator": null
}
},
"panSource": "ON-FILE",
"addressVerificationResultCode": null,
"cvv2ResultsCode": null,
"consumerEntryMode": null,
"consumerLanguage": null,
"termsAndConditions": null,
"issuerSpecialConditionCodes": null,
"deviceInfo": null,
"deviceId": null,
"services": [
"DIGITIZATION"
],
"correlationId": "RAMB-afc50842-e802-4539-be0f-f5cb1fb",
"walletId": null,
"paymentAppInstanceId": null,
"secureElementId": null,
"accountPanSuffix": null,
"serviceRequestDateTime": null,
"productConfigurationId": null,
"decision": null,
"decisionMadeBy": null,
"tokenActivatedDateTime": null,
"numberOfActivationAttempts": "0",
"tokenStatus": "ACTIVE",
"reasonCode": null,
"suspendedBy": null,
"tokenExpiry": null,
"issuerId": null,
"isEnrolmentFinish": null,
"source": null,
"cardStatusUpdateResult": "false",
"isPrimaryToken": null,
"tokenUserInfo": null,
"merchantInfo": null,
"cardHolderStepupResult": null,
"deviceBindingResult": null,
"trustedListingResult": null,
"errorCode": null,
"errorMessage": null,
"tokenRequestorTspID": "testing",
"locale": "en-US",
"tokenInfo": {
"token": "testing_token",
"tokenType": null,
"tokenStatus": null,
"sequenceNumber": null,
"tokenExpiry": null,
"tokenAssuranceLevel": null,
"numberOfActiveTokensForPAN": 0,
"numberOfInactiveTokensForPAN": 0,
"numberOfSuspendedTokensForPAN": 0,
"tokenActivationDate": null,
"tokenDeactivationDate": null,
"lastTokenStatusUpdatedTime": null,
"originalToken": null,
"originalTokenRequestorID": null,
"originalTokenReferenceID": null,
"originalTokenAssuranceLevel": null,
"originalTokenAssuranceMethod": null,
"tokenAssuranceMethod": null,
"originalTokenType": null,
"tokenRequestorName": null,
"autoFillIndicator": null
}
}
}
}3. SUSPENDED
{
"SUMMARY": {
"Processor_Decision_Code": null,
"Wallet": null,
"Client_Id": 123456,
"Date_Time": "2023-02-08 09:52:23.845",
"Token_Status": 1000,
"Api_Call_Unique_Identifier": "15118955031675824736543",
"OTP": 123456,
"Source": "MEA Wallet",
"Device": null,
"Network": "VISA",
"Token": 100046490,
"PID": 7,
"Message_Reason": "Token Notification: SUSPENDED"
},
"MESSAGE_TYPE": {
"Message_Type": "TNR",
"Message_Desc": "Tokenization Notification Request",
"Version": "1"
},
"ADDITIONAL_MESSAGE_DATA": {
"paymentNetwork": "VISA",
"reasonCode": "SUSPENDED",
"tokenUniqueReference": "DMEAMC000000003256CEB30FB095FEDD20C2AD03D2DB5FA3",
"panUniqueReference": "FWSPMC000000000159f71f703d2141efaf04dd26803f922b",
"paymentAccountReference": "5001a9f027e5629d11e3949a0800a",
"tokenRequestorId": "90876543210",
"walletId": "123",
"paymentAppInstanceId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e",
"tokenType": "EMBEDDED_SE",
"tokenState": "SUSPENDED",
"secureElementId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e93452c",
"cardInfo": {
"source": "CARD_ADDED_MANUALLY"
},
"eventOriginatorName": "ISSUER",
"deviceInfo": {
"deviceID": "ehoqgncrksfrconzqirhsxfeefqgmafkorqzlyufuyccrqwy", //Required Visa
"deviceIndex": 1,
"serialNumber": "2F6D63",
"formFactor": "PHONE",
"isoDeviceType": "09",
"osName": "IOS",
"osVersion": "4.4",
"imei": "352099001761481",
"msisdn": "7307406945",
"paymentTypes": [
"NFC",
"DSRP"
],
"storageTechnology": "SE",
"cardCaptureTechnology": "CAMERA"
}
}
}4. RESUMED
{
"SUMMARY": {
"Processor_Decision_Code": null,
"Wallet": null,
"Client_Id": 123456,
"Date_Time": "2023-02-08 09:52:23.845",
"Token_Status": 1000,
"Api_Call_Unique_Identifier": "15118955031675824736543",
"OTP": 123456,
"Source": "MEA Wallet",
"Device": null,
"Network": "VISA",
"Token": 100046490,
"PID": 7,
"Message_Reason": "Token Notification: RESUMED",
},
"MESSAGE_TYPE": {
"Message_Type": "TNR",
"Message_Desc": "Tokenization Notification Request",
"Version": "1"
},
"ADDITIONAL_MESSAGE_DATA": {
"paymentNetwork": "VISA",
"reasonCode": "RESUMED",
"tokenUniqueReference": "DMEAMC000000003256CEB30FB095FEDD20C2AD03D2DB5FA3",
"panUniqueReference": "FWSPMC000000000159f71f703d2141efaf04dd26803f922b",
"paymentAccountReference": "5001a9f027e5629d11e3949a0800a",
"tokenRequestorId": "90876543210",
"walletId": "123",
"paymentAppInstanceId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e",
"tokenType": "EMBEDDED_SE",
"tokenState": "ACTIVE",
"secureElementId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e93452c",
"cardInfo": {
"source": "CARD_ADDED_MANUALLY"
},
"eventOriginatorName": "ISSUER",
"deviceInfo": {
"deviceID": "ehoqgncrksfrconzqirhsxfeefqgmafkorqzlyufuyccrqwy", //Required Visa
"deviceIndex": 1,
"serialNumber": "2F6D63",
"formFactor": "PHONE",
"isoDeviceType": "09",
"osName": "IOS",
"osVersion": "4.4",
"imei": "352099001761481",
"msisdn": "7307406945",
"paymentTypes": [
"NFC",
"DSRP"
],
"storageTechnology": "SE",
"cardCaptureTechnology": "CAMERA"
}
}
}5. DELETED
{
"SUMMARY": {
"Processor_Decision_Code": null,
"Wallet": null,
"Client_Id": 123456,
"Date_Time": "2023-02-08 09:52:23.845",
"Token_Status": 1000,
"Api_Call_Unique_Identifier": "15118955031675824736543",
"OTP": 123456,
"Source": "MEA Wallet",
"Device": null,
"Network": "VISA",
"Token": 100046490,
"PID": 7,
"Message_Reason": "Token Notification: DELETED",
},
"MESSAGE_TYPE": {
"Message_Type": "TNR",
"Message_Desc": "Tokenization Notification Request",
"Version": "1"
},
"ADDITIONAL_MESSAGE_DATA": {
"paymentNetwork": "VISA",
"reasonCode": "DELETED",
"tokenUniqueReference": "DMEAMC000000003256CEB30FB095FEDD20C2AD03D2DB5FA3",
"panUniqueReference": "FWSPMC000000000159f71f703d2141efaf04dd26803f922b",
"paymentAccountReference": "5001a9f027e5629d11e3949a0800a",
"tokenRequestorId": "90876543210",
"walletId": "123",
"paymentAppInstanceId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e",
"tokenType": "EMBEDDED_SE",
"tokenState": "DEACTIVATED",
"secureElementId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e93452c",
"cardInfo": {
"source": "CARD_ADDED_MANUALLY"
},
"eventOriginatorName": "ISSUER",
"deviceInfo": {
"deviceID": "ehoqgncrksfrconzqirhsxfeefqgmafkorqzlyufuyccrqwy", //Required Visa
"deviceIndex": 1,
"serialNumber": "2F6D63",
"formFactor": "PHONE",
"isoDeviceType": "09",
"osName": "IOS",
"osVersion": "4.4",
"imei": "352099001761481",
"msisdn": "7307406945",
"paymentTypes": [
"NFC",
"DSRP"
],
"storageTechnology": "SE",
"cardCaptureTechnology": "CAMERA"
}
}
}6. RENEWED
{
"SUMMARY": {
"Processor_Decision_Code": null,
"Wallet": null,
"Client_Id": 123456,
"Date_Time": "2023-02-08 09:52:23.845",
"Token_Status": 1000,
"Api_Call_Unique_Identifier": "15118955031675824736543",
"OTP": 123456,
"Source": "MEA Wallet",
"Device": null,
"Network": "VISA",
"Token": 100046490,
"PID": 7,
"Message_Reason": "Token Notification: RENEWED",
},
"MESSAGE_TYPE": {
"Message_Type": "TNR",
"Message_Desc": "Tokenization Notification Request",
"Version": "1"
},
"ADDITIONAL_MESSAGE_DATA": {
"paymentNetwork": "VISA",
"reasonCode": "RENEWED",
"tokenUniqueReference": "DMEAMC000000003256CEB30FB095FEDD20C2AD03D2DB5FA3",
"panUniqueReference": "FWSPMC000000000159f71f703d2141efaf04dd26803f922b",
"paymentAccountReference": "5001a9f027e5629d11e3949a0800a",
"tokenRequestorId": "90876543210",
"walletId": "123",
"paymentAppInstanceId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e",
"tokenType": "EMBEDDED_SE",
"tokenState": "RENEWED",
"secureElementId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e93452c",
"cardInfo": {
"source": "CARD_ADDED_MANUALLY"
},
"eventOriginatorName": "ISSUER",
"deviceInfo": {
"deviceID": "ehoqgncrksfrconzqirhsxfeefqgmafkorqzlyufuyccrqwy", //Required Visa
"deviceIndex": 1,
"serialNumber": "2F6D63",
"formFactor": "PHONE",
"isoDeviceType": "09",
"osName": "IOS",
"osVersion": "4.4",
"imei": "352099001761481",
"msisdn": "7307406945",
"paymentTypes": [
"NFC",
"DSRP"
],
"storageTechnology": "SE",
"cardCaptureTechnology": "CAMERA"
}
}
}7. DEVICE_BINDING_APPROVED
{
"SUMMARY": {
"Processor_Decision_Code": null,
"Wallet": null,
"Client_Id": 123456,
"Date_Time": "2023-02-08 09:52:23.845",
"Token_Status": 1000,
"Api_Call_Unique_Identifier": "15118955031675824736543",
"OTP": 123456,
"Source": "MEA Wallet",
"Device": null,
"Network": "VISA",
"Token": 100046490,
"PID": 7,
"Message_Reason": "Token Notification: DEVICE_BINDING_APPROVED",
},
"MESSAGE_TYPE": {
"Message_Type": "TNR",
"Message_Desc": "Tokenization Notification Request",
"Version": "1"
},
"ADDITIONAL_MESSAGE_DATA": {
"paymentNetwork": "VISA",
"reasonCode": "DEVICE_BINDING_APPROVED",
"tokenUniqueReference": "DMEAMC000000003256CEB30FB095FEDD20C2AD03D2DB5FA3",
"panUniqueReference": "FWSPMC000000000159f71f703d2141efaf04dd26803f922b",
"paymentAccountReference": "5001a9f027e5629d11e3949a0800a",
"tokenRequestorId": "90876543210",
"walletId": "123",
"paymentAppInstanceId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e",
"tokenType": "EMBEDDED_SE",
"tokenState": "ACTIVE",
"decisionMadeBy": "RULE_ENGINE",
"secureElementId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e93452c",
"cardInfo": {
"source": "CARD_ADDED_MANUALLY"
},
"eventOriginatorName": "ISSUER",
"deviceInfo": {
"deviceID": "ehoqgncrksfrconzqirhsxfeefqgmafkorqzlyufuyccrqwy", //Required Visa
"deviceIndex": 1,
"serialNumber": "2F6D63",
"formFactor": "PHONE",
"isoDeviceType": "09",
"osName": "IOS",
"osVersion": "4.4",
"imei": "352099001761481",
"msisdn": "7307406945",
"paymentTypes": [
"NFC",
"DSRP"
],
"storageTechnology": "SE",
"cardCaptureTechnology": "CAMERA"
}
}
}8. DEVICE_BINDING_REMOVED
{
"SUMMARY": {
"Processor_Decision_Code": null,
"Wallet": null,
"Client_Id": 123456,
"Date_Time": "2023-02-08 09:52:23.845",
"Token_Status": 1000,
"Api_Call_Unique_Identifier": "15118955031675824736543",
"OTP": 123456,
"Source": "MEA Wallet",
"Device": null,
"Network": "VISA",
"Token": 100046490,
"PID": 7,
"Message_Reason": "Token Notification: DEVICE_BINDING_REMOVED",
},
"MESSAGE_TYPE": {
"Message_Type": "TNR",
"Message_Desc": "Tokenization Notification Request",
"Version": "1"
},
"ADDITIONAL_MESSAGE_DATA": {
"paymentNetwork": "VISA",
"reasonCode": "DEVICE_BINDING_REMOVED",
"tokenUniqueReference": "DMEAMC000000003256CEB30FB095FEDD20C2AD03D2DB5FA3",
"panUniqueReference": "FWSPMC000000000159f71f703d2141efaf04dd26803f922b",
"paymentAccountReference": "5001a9f027e5629d11e3949a0800a",
"tokenRequestorId": "90876543210",
"walletId": "123",
"paymentAppInstanceId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e",
"tokenType": "EMBEDDED_SE",
"tokenState": "ACTIVE",
"secureElementId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e93452c",
"cardInfo": {
"source": "CARD_ADDED_MANUALLY"
},
"eventOriginatorName": "ISSUER",
"deviceInfo": {
"deviceID": "ehoqgncrksfrconzqirhsxfeefqgmafkorqzlyufuyccrqwy", //Required Visa
"deviceIndex": 1,
"serialNumber": "2F6D63",
"formFactor": "PHONE",
"isoDeviceType": "09",
"osName": "IOS",
"osVersion": "4.4",
"imei": "352099001761481",
"msisdn": "7307406945",
"paymentTypes": [
"NFC",
"DSRP"
],
"storageTechnology": "SE",
"cardCaptureTechnology": "CAMERA"
}
}
}9. PROVISIONING_DECLINED
{
"SUMMARY": {
"Processor_Decision_Code": null,
"Wallet": null,
"Client_Id": 123456,
"Date_Time": "2023-02-08 09:52:23.845",
"Token_Status": 1000,
"Api_Call_Unique_Identifier": "15118955031675824736543",
"OTP": 123456,
"Source": "MEA Wallet",
"Device": null,
"Network": "VISA",
"Token": 100046490,
"PID": 7,
"Message_Reason": "Token Notification: PROVISIONING_DECLINED",
},
"MESSAGE_TYPE": {
"Message_Type": "TNR",
"Message_Desc": "Tokenization Notification Request",
"Version": "1"
},
"ADDITIONAL_MESSAGE_DATA": {
"paymentNetwork": "VISA",
"reasonCode": "PROVISIONING_DECLINED",
"tokenUniqueReference": "DMEAMC000000003256CEB30FB095FEDD20C2AD03D2DB5FA3",
"panUniqueReference": "FWSPMC000000000159f71f703d2141efaf04dd26803f922b",
"paymentAccountReference": "5001a9f027e5629d11e3949a0800a",
"tokenRequestorId": "90876543210",
"walletId": "123",
"paymentAppInstanceId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e",
"tokenType": "EMBEDDED_SE",
"tokenState": "INACTIVE",
"decisionMadeBy": "RULE_ENGINE",
"decisionReason": "WALLET_RECOMMENDS_HIGH_RISK",
"secureElementId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e93452c",
"cardInfo": {
"source": "CARD_ADDED_MANUALLY"
},
"eventOriginatorName": "ISSUER",
"deviceInfo": {
"deviceID": "ehoqgncrksfrconzqirhsxfeefqgmafkorqzlyufuyccrqwy",
"deviceIndex": 1,
"serialNumber": "2F6D63",
"formFactor": "PHONE",
"isoDeviceType": "09",
"osName": "IOS",
"osVersion": "4.4",
"imei": "352099001761481",
"msisdn": "7307406945",
"paymentTypes": [
"NFC",
"DSRP"
],
"storageTechnology": "SE",
"cardCaptureTechnology": "CAMERA"
}
}
}10. REDIGITIZATION_COMPLETE
{
"SUMMARY": {
"Processor_Decision_Code": null,
"Wallet": null,
"Client_Id": 123456,
"Date_Time": "2023-02-08 09:52:23.845",
"Token_Status": 1000,
"Api_Call_Unique_Identifier": "15118955031675824736543",
"OTP": 123456,
"Source": "MEA Wallet",
"Device": null,
"Network": "VISA",
"Token": 100046490,
"PID": 7,
"Message_Reason": "Token Notification: REDIGITIZATION_COMPLETE",
},
"MESSAGE_TYPE": {
"Message_Type": "TNR",
"Message_Desc": "Tokenization Notification Request",
"Version": "1"
},
"ADDITIONAL_MESSAGE_DATA": {
"paymentNetwork": "VISA",
"reasonCode": "REDIGITIZATION_COMPLETE",
"tokenUniqueReference": "DMEAMC000000003256CEB30FB095FEDD20C2AD03D2DB5FA3",
"panUniqueReference": "FWSPMC000000000159f71f703d2141efaf04dd26803f922b",
"paymentAccountReference": "5001a9f027e5629d11e3949a0800a",
"tokenRequestorId": "90876543210",
"walletId": "123",
"paymentAppInstanceId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e",
"tokenType": "EMBEDDED_SE",
"tokenState": "ACTIVE",
"secureElementId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e93452c",
"cardInfo": {
"source": "CARD_ADDED_MANUALLY"
},
"eventOriginatorName": "ISSUER",
"deviceInfo": {
"deviceID": "ehoqgncrksfrconzqirhsxfeefqgmafkorqzlyufuyccrqwy",
"deviceIndex": 1,
"serialNumber": "2F6D63",
"formFactor": "PHONE",
"isoDeviceType": "09",
"osName": "IOS",
"osVersion": "4.4",
"imei": "352099001761481",
"msisdn": "7307406945",
"paymentTypes": [
"NFC",
"DSRP"
],
"storageTechnology": "SE",
"cardCaptureTechnology": "CAMERA"
}
}
}11. DELETED_FROM_CONSUMER_APP
{
"SUMMARY": {
"Processor_Decision_Code": null,
"Wallet": null,
"Client_Id": 123456,
"Date_Time": "2023-02-08 09:52:23.845",
"Token_Status": 1000,
"Api_Call_Unique_Identifier": "15118955031675824736543",
"OTP": 123456,
"Source": "MEA Wallet",
"Device": null,
"Network": "VISA",
"Token": 100046490,
"PID": 7,
"Message_Reason": "Token Notification: DELETED_FROM_CONSUMER_APP",
},
"MESSAGE_TYPE": {
"Message_Type": "TNR",
"Message_Desc": "Tokenization Notification Request",
"Version": "1"
},
"ADDITIONAL_MESSAGE_DATA": {
"paymentNetwork": "VISA",
"reasonCode": "DELETED_FROM_CONSUMER_APP",
"tokenUniqueReference": "DMEAMC000000003256CEB30FB095FEDD20C2AD03D2DB5FA3",
"panUniqueReference": "FWSPMC000000000159f71f703d2141efaf04dd26803f922b",
"paymentAccountReference": "5001a9f027e5629d11e3949a0800a",
"tokenRequestorId": "90876543210",
"walletId": "123",
"paymentAppInstanceId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e",
"tokenType": "EMBEDDED_SE",
"tokenState": "ACTIVE",
"secureElementId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e93452c",
"cardInfo": {
"source": "CARD_ADDED_MANUALLY"
},
"eventOriginatorName": "ISSUER",
"deviceInfo": {
"deviceID": "ehoqgncrksfrconzqirhsxfeefqgmafkorqzlyufuyccrqwy",
"deviceIndex": 1,
"serialNumber": "2F6D63",
"formFactor": "PHONE",
"isoDeviceType": "09",
"osName": "IOS",
"osVersion": "4.4",
"imei": "352099001761481",
"msisdn": "7307406945",
"paymentTypes": [
"NFC",
"DSRP"
],
"storageTechnology": "SE",
"cardCaptureTechnology": "CAMERA"
}
}
}12. STATUS_UPDATE
{
"SUMMARY": {
"Processor_Decision_Code": null,
"Wallet": null,
"Client_Id": 123456,
"Date_Time": "2023-02-08 09:52:23.845",
"Token_Status": 1000,
"Api_Call_Unique_Identifier": "15118955031675824736543",
"OTP": 123456,
"Source": "MEA Wallet",
"Device": null,
"Network": "VISA",
"Token": 100046490,
"PID": 7,
"Message_Reason": "Token Notification: STATUS_UPDATE",
},
"MESSAGE_TYPE": {
"Message_Type": "TNR",
"Message_Desc": "Tokenization Notification Request",
"Version": "1"
},
"ADDITIONAL_MESSAGE_DATA": {
"paymentNetwork": "VISA",
"reasonCode": "STATUS_UPDATE",
"tokenUniqueReference": "DMEAMC000000003256CEB30FB095FEDD20C2AD03D2DB5FA3",
"panUniqueReference": "FWSPMC000000000159f71f703d2141efaf04dd26803f922b",
"paymentAccountReference": "5001a9f027e5629d11e3949a0800a",
"tokenRequestorId": "90876543210",
"walletId": "123",
"paymentAppInstanceId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e",
"tokenType": "EMBEDDED_SE",
"tokenState": "ACTIVE",
"secureElementId": "1b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e93452c",
"cardInfo": {
"source": "CARD_ADDED_MANUALLY"
},
"eventOriginatorName": "ISSUER",
"deviceInfo": {
"deviceID": "ehoqgncrksfrconzqirhsxfeefqgmafkorqzlyufuyccrqwy",
"deviceIndex": 1,
"serialNumber": "2F6D63",
"formFactor": "PHONE",
"isoDeviceType": "09",
"osName": "IOS",
"osVersion": "4.4",
"imei": "352099001761481",
"msisdn": "7307406945",
"paymentTypes": [
"NFC",
"DSRP"
],
"storageTechnology": "SE",
"cardCaptureTechnology": "CAMERA"
}
}
}13. INCOMPLETE_PROVISIONING
{
"SUMMARY": {
"Processor_Decision_Code": null,
"Wallet": null,
"Client_Id": 123456,
"Date_Time": "2023-02-08 09:52:23.845",
"Token_Status": 1000,
"Api_Call_Unique_Identifier": "15118955031675824736543",
"OTP": null,
"Source": "MEA Wallet",
"Device": null,
"Network": "VISA",
"Token": 100046490,
"PID": 7,
"Message_Reason": "Token Notification: INCOMPLETE_PROVISIONING ",
},
"MESSAGE_TYPE": {
"Message_Type": "TNR",
"Message_Desc": "Tokenization Notification Request",
"Version": "1"
},
"ADDITIONAL_MESSAGE_DATA": {
"paymentNetwork": "VISA",
"reasonCode": "INCOMPLETE_PROVISIONING",
"tokenUniqueReference": "DMEAMC000000003256CEB30FB095FEDD20C2AD03D2DB5FA3",
"walletId": "123",
"tokenCreatedDateTime ": "2023-04-18T12:08:56.123+02:00",
"cardholderContactDetails": {
"mobile": "00923334523807",
"email": "[email protected]"
}
}
}Updated 5 months ago