{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"3aca5533-1682-443d-8279-42fc89728088","name":"Decrypt","description":"Decrypt is one of the Magensa web services used for the POS (Point of Sale) transactions. At POS transactions, high security is required as extremely sensitive information is handled. \nThere are three operations in the decrypt service. \n• DecryptCardSwipe \n• DecryptData \n• GenerateMac\n\n# Decrypt 3.0 Operations\n\n## DecryptData\n\nA command used to decrypt a block of data. This command supports any data encrypted by a MagTek reader including bulk data or individually encrypted fields such as tracks.\n\n### Input Properties\n\n| Property(\\*) | Value | Description |\n| --- | --- | --- |\n| BillingLabel | | A user selected value that can be included in Reports or Requests. Max length of 64 characters |\n| CustomerTransactionID | | A user selected value that can be included in Reports or Requests. Max length of 256 characters. |\n| CustomerCode \\* | | Customer code provided by Magensa at onboard time. |\n| Password \\* | | Password credential provided by Magensa at onboard time. |\n| UserName \\* | | User name credential provided by Magensa at onboard time. |\n| Encrypted Data | | Encrypted data block cryptogram in Hexadecimal format in multiples of 8 byte blocks (16 characters per block). |\n| KSN \\* | | Key Serial Number of the reader |\n| KeyType \\* | | Key type to be used to decrypt the data block cryptogram.
This value shall be set to match the reader configuration.
Enum values:
Pin - Pin variant key
Data - Data variant key |\n\nNote: \\* = Required\n\n### Output Properties\n\n| Property | | Value | Property Description |\n| --- | --- | --- | --- |\n| CustomerTransactionID | | | A user selected value that can be included in Reports or Requests. Max length of 256 characters. |\n| IsReplay | | | Boolean value informing that the KSN has been used in a prior transaction.
Enum values:
true – KSN has been used in a prior transaction.
false – KSN has not been used prior to current transaction. |\n| MagTranId | | | Transaction ID in GUID alpha numeric form. |\n| DecryptedData | | | Decrypted data including any pad characters. |\n\n### DecryptData Request\n\n``` xml\nxmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\" xmlns:tem=\"http://tempuri.org/\" xmlns:dec=\"http://schemas.datacontract.org/2004/07/Decrypt.Core\">\n\n\n\nOptional: -->\n\nOptional: -->\n\nOptional: -->\n\nOptional: -->\n\nOptional: -->\ncustomercode\nOptional: -->\npassword\nOptional: -->\nusername\n\nOptional: -->\n5F260E4080089DB1F2DAE45114E285C81C47B8395B33C547C231538C7447C3EBCAB430B57E491E332640EEDB3871B5F4A347DE69258B8B39E870A0BAE3DF59E17050F77DB3E46FDDE46F4CF6DB0BA63961085FBDE67AA4359A727BB6250EA1A9CFC51B609C83152DD63BF8989B0E9273713F6BFD80BE5526FB1E5B50ABEC7062897263307607A714A2C1822A3DEC72987E0C4D44412ECFC38CD0424AD77CDAC01B288074D8A\n36E528F79DF81DE739FA05AECD54A13518F4C290EA3DDFCCA6C6ACFF0012FC3939D02CD13704B08D23CA00DBF7681A32B1ACB2822854BBDE9CE75D20B5E0D89968F502546F13\n34B822E094C4AFE52ACA66E2662F0AD4B17314A64F28477E22D5F2B33\nOptional: -->\n9011400B487DBC000011\nOptional: -->\nData\n\n\n\n\n\n ```\n\nBelow is the soap response for DecryptData operation of Decrypt service. [https://svc72.magensa.net/DecryptV3/Decrypt.svc?wsdl](https://svc72.magensa.net/DecryptV3/Decrypt.svc?wsdl)\n\n### DecryptData Response\n\n``` xml\n\n \n \n \n \n true\n 2c193b5c-de38-43d5-bc3b-73f34b812ea2 FC820102F28200FE820239008E1200000000000000004203440341031E031F035F24031909305F25031711019F0607A00000000410109F0702FFC09F0D05BC50BC08009F0E0500000000009F0F05BC70BC98009F10120210600003220000000000000000000000FF9F2608B4E47438FF561F5B9F2701409F36020003950504000080009B02E8009C01009F33032028C89F34031E03009F3704486F61809F400572\n0000B0015A0853256148000134559F02060000000015009F03060000000000009F1A02084057135325614800013455D19092010010005410000F8A0230309F10120210600003220000000000000000000000FF50104465626974204D6173746572436172640000\n \n \n \n \n\n ```\n\n## GenerateMac\n\nA command used to generate a MAC (Message Authentication Code) against a data block.\n\n### Input Properties\n\nThe GenerateMac operation request has below Input properties.\n\n| Property | Value | Description |\n| --- | --- | --- |\n| BillingLabel | | A user selected value that can be included in Reports or Requests. Max length of 64 characters. |\n| CustomerTransactionID | | A user selected value that can be included in Reports or Requests. Max length of 256 characters. |\n| CustomerCode \\* | | Customer code provided by Magensa at onboard time. |\n| Password \\* | | Password credential provided by Magensa at onboard time. |\n| UserName \\* | | User name credential provided by Magensa at onboard time. |\n| DataToMAC\\* | | Encrypted data block cryptogram in Hexadecimal format in multiples of 8 byte blocks (16 characters per block). |\n| KSN \\* | | Key Serial Number of the reader |\n| KeyDerivationType\\* | | Key type to be used to decrypt the data block cryptogram.
This value shall be set to match the reader configuration.
Enum values:
DUKPT - DUKPT method
Fixed - Fix method |\n\nNote: \\* = Required\n\n### Output Properties\n\n| Property | Value | Description |\n| --- | --- | --- |\n| CustomerTransactionID | | Customer transaction ID |\n| IsReplay | | Boolean value informing that the KSN has been used in a prior transaction.
Enum values:
true – KSN has been used in a prior transaction.
false – KSN has not been used prior to current transaction. |\n| MagTranId | | Transaction ID in GUID alpha numeric form. |\n| MACedString | | MAC bytes (16 Hex characters) |\n\nGenerateMac is for generating a Message Authentication Code (MAC) against a data block. MAC is used to authenticate a message, to confirm that the message came from the authorized sender and has not been changed. Mac protects both data integrity and authenticity of the message.\n\n### GenerateMac Request\n\n``` xml\n\n\n\n\nBillingLabel CustomerTransactionID\ncustomercode\npassword\nusername\n sedec:DataToMAC>343031323334353637383930394439383700000000000000\n9010010B31ED13000001\nDUKPT\n\n\n\n\n\n ```\n\n### GenerateMac Response\n\n``` xml\n\n \n \n \n CustomerTransactionID\n true\n 00350c72-23bf-4da6-9bb7-b4804889f4df\n 2F19A27110AA871E\n \n\n \n\n\n ```\n\n## DecryptCardSwipe\n\nA command used to decrypt card swipes.\n\n### Input Properties\n\n| Property | Value | Property Description |\n| --- | --- | --- |\n| BillingLabel | | A user selected value that can be included in Reports or Requests. Max length of 64 characters. |\n| CustomerTransactionID | | A user selected value that can be included in Reports or Requests. Max length of 256 characters. |\n| CustomerCode \\* | | Customer code provided by Magensa at onboard time. |\n| Password \\* | | Password credential provided by Magensa at onboard time. |\n| UserName \\* | | User name credential provided by Magensa at onboard time. |\n| DeviceSN | | Device serial number of the reader |\n| KSN \\* | | Key serial number of the reader |\n| KeyType \\* | | Key type to be used to decrypt the data block cryptogram.
This value shall be set to match the reader configuration.
Enum values:
Pin - Pin variant key
Data - Data variant key |\n| MagnePrint \\* | | Copy the data exactly as it is transmitted from the reading device. If the transaction is hand keyed, fill this field with 112 zeros. |\n| MagnePrintStatus \\* | | Copy the data exactly as it is transmitted from the reading device. If the transaction is hand keyed, fill this field with 8 zeros. |\n| Track1 | | Encrypted Track 1 data in Hexadecimal format in multiples of 8 byte blocks (16 characters per block). |\n| Track2 \\* | | Encrypted Track 2 data in Hexadecimal format in multiples of 8 byte blocks (16 characters per block). |\n| Track3 | | Encrypted Track 3 data in Hexadecimal format in multiples of 8 byte blocks (16 characters per block). |\n\nNote: \\* = Required\n\n### Output Properties\n\n| Property | Value | Property Description |\n| --- | --- | --- |\n| CustomerTransactionID | | Customer transaction ID |\n| IsReplay | | Boolean value informing that the KSN has been used in a prior transaction.
Enum values:
true – KSN has been used in a prior transaction.
false – KSN has not been used prior to current transaction. |\n| MagTranId | | Transaction ID in GUID alpha numeric form. |\n| CardID | | Hashed CardID. |\n| MagnePrint | | MagnePrint decrypted value. |\n| Track1 | | Decrypted Track 1 data. |\n| Track2 | | Decrypted Track 2 data. |\n| Track3 | | Decrypted Track 3 data. |\n| MagnePrintScore | | MagnePrint Score.
Valid scores are greater than or equal to -1 and less than or
equal to 1.
Any score above 1 is an error. |\n\nThe Web Services Description Language URL for consuming this web service may be located at: [https://svc72.magensa.net/DecryptV3/Decrypt.svc?wsdl](https://svc72.magensa.net/DecryptV3/Decrypt.svc?wsdl)\n\n### DecryptCardSwipe Request\n\n``` xml\n\n \n \n \n Optional: -->\n \n Optional: -->\n 0\n Optional: -->\n 0\n \n Optional: -->\n customercode\n Optional: -->\n password\n Optional: -->\n username\n \n \n Optional: -->\n B487DA9022119AA\n 9011400B487DA9000007\n Optional: -->\n Pin\n Optional: -->\n A4C4870970E452710FCBFD6D3388ECC2121D4B28A0282DEA7523A5E9470B6B731D28AE31A7C828B89E684A7413006EA5AB0BC4B51F74EBAC\n Optional: -->\n 61401400\n Optional: -->\n 54EE1021145099EC55772C6C00B0D3CE6BCE1B0266E6483FD76F80243AE91286596AD0761840B731EC9A2168BB6943B3BE5FE7E605EF732122DC852E14DEF760BB40CBFE2F4B91AB\n Optional: -->\n B156DB6D856FA0592C0C3029745053F9C1701836FB35B87E091BEE77E9446E97B86DD0D1CD5597D8\n Optional: -->\n \n \n \n \n \n\n\n ```\n\n### DecryptCardSwipe Response\n\n``` xml\n\n\n\n\n0\ntrue\n7fe9fb87-9220-4aa0-b5cb-5a003829132f uISJfty0btbZIRbjfwLWjMrdOl0Es+r4LjGqZh45U1E=\n 020020882CDC25063DA83890AB3E736FC7879F510AEBFD6F150B4D87D8B94E9BCDE760932E0CED36C0702909E6D03808DF16D0026ACE0000%B5325614800013455^CONTACTLESS/MAGTEK D^190920100100OP 00669000000?\n ;5325614800013455=19092010010066910000? \n0.7584068\n\n\n\n\n ```\n\n# Status Codes and Messages\n\nStatus Codes and Messages returned by Magensa for Decrypt 3.0 Operations.\n\nInternal errors\n\n| Code | StatusMsg | Notes |\n| --- | --- | --- |\n| 5000 | Unknown Error | |\n\nInput Validation Errors\n\n| Code | StatusMsg | | Notes |\n| --- | --- | --- | --- |\n| 601 | EncryptedData is required | | |\n| 602 | KSN is required | | |\n| 603 | CustomerCode is required | | |\n| 604 | Username is required | | |\n| 605 | Password is required | | |\n| 606 | EncryptedData is not valid | Either the value was not HEX, not multiple of 16 characters, or the value was too long. | |\n| 607 | KSN is not valid | Either the value was not HEX, or the value was too long. | |\n| 608 | DataToMac is required | | |\n| 610 | Track2 is required | | |\n| 611 | MagnePrint is required | | |\n| 612 | Track2 is not valid | Either the value was not HEX, not multiple of 16 characters, or the value was too long. | |\n| 613 | MagnePrint is not valid | Either the value was not HEX, not multiple of 16 characters, or the value was too long. | |\n| 614 | MagnePrint Status is required | | |\n| 615 | CustomerTransactionID is not valid | Occurs if the length is more than 256 characters. | |\n| 616 | BillingLabel is not valid | Occurs if the length is more than 64 characters. | |\n| 655 | Track1 is not valid | Either the value was not HEX, not multiple of 16 characters, or the value was too long. | |\n| 656 | Track3 is not valid | Either the value was not HEX, not multiple of 16 characters, or the value was too long. | |\n| 657 | DataToMAC is not valid | Either the value was not HEX, not multiple of 16 characters, or the value was too long. | |\n\nOther Errors\n\n| Code | StatusMsg | | Notes |\n| --- | --- | --- | --- |\n| 701 | Access Denied | | |\n| 702 | Device Not Allowed | | |\n| 706 | KSID Access Denied | | |","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"33729815","team":6083045,"collectionId":"3aca5533-1682-443d-8279-42fc89728088","publishedId":"2sAYdkJVAe","public":true,"publicUrl":"https://decrypt.developer.magtek.com","privateUrl":"https://go.postman.co/documentation/33729815-3aca5533-1682-443d-8279-42fc89728088","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-single-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.0","publishDate":"2025-03-05T16:20:44.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/54710abbcbe0595b52ebedcdb464cfaf3ee177ca1c5a5d0850c1dc24c3508caf","favicon":"https://res.cloudinary.com/postman/image/upload/v1741199418/team/2b0e542073ba9f727998a67f8bd10fe7.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://decrypt.developer.magtek.com/view/metadata/2sAYdkJVAe"}