{"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.
There are three operations in the decrypt service.
• DecryptCardSwipe
• DecryptData
• GenerateMac

Decrypt 3.0 Operations

DecryptData

A 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.

Input Properties

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Property(*)	Value	Description
BillingLabel		A user selected value that can be included in Reports or Requests. Max length of 64 characters
CustomerTransactionID		A user selected value that can be included in Reports or Requests. Max length of 256 characters.
CustomerCode *		Customer code provided by Magensa at onboard time.
Password *		Password credential provided by Magensa at onboard time.
UserName *		User name credential provided by Magensa at onboard time.
Encrypted Data		Encrypted data block cryptogram in Hexadecimal format in multiples of 8 byte blocks (16 characters per block).
KSN *		Key Serial Number of the reader
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

Note: * = Required

Output Properties

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Property		Value	Property Description
CustomerTransactionID			A user selected value that can be included in Reports or Requests. Max length of 256 characters.
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.
MagTranId			Transaction ID in GUID alpha numeric form.
DecryptedData			Decrypted data including any pad characters.

DecryptData Request

xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\" xmlns:tem=\"http://tempuri.org/\" xmlns:dec=\"http://schemas.datacontract.org/2004/07/Decrypt.Core\">\n<soapenv:Header/>\n<soapenv:Body>\n<tem:DecryptData>\n<comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n<tem:request>\n<comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n<dec:BillingLabel></dec:BillingLabel>\n<comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n<dec:CustomerTransactionID></dec:CustomerTransactionID>\n<comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n<dec:Authentication>\n<comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n<dec:CustomerCode>customercode</dec:CustomerCode>\n<comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n<dec:Password>password</dec:Password>\n<comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n<dec:Username>username</dec:Username>\n</dec:Authentication>\n<comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n<dec:EncryptedData>5F260E4080089DB1F2DAE45114E285C81C47B8395B33C547C231538C7447C3EBCAB430B57E491E332640EEDB3871B5F4A347DE69258B8B39E870A0BAE3DF59E17050F77DB3E46FDDE46F4CF6DB0BA63961085FBDE67AA4359A727BB6250EA1A9CFC51B609C83152DD63BF8989B0E9273713F6BFD80BE5526FB1E5B50ABEC7062897263307607A714A2C1822A3DEC72987E0C4D44412ECFC38CD0424AD77CDAC01B288074D8A\n36E528F79DF81DE739FA05AECD54A13518F4C290EA3DDFCCA6C6ACFF0012FC3939D02CD13704B08D23CA00DBF7681A32B1ACB2822854BBDE9CE75D20B5E0D89968F502546F13\n34B822E094C4AFE52ACA66E2662F0AD4B17314A64F28477E22D5F2B33</dec:EncryptedData>\n<comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n<dec:KSN>9011400B487DBC000011</dec:KSN>\n<comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n<dec:KeyType>Data</dec:KeyType>\n</tem:request>\n</tem:DecryptData>\n</soapenv:Body>\n</soapenv:Envelope>\n\n

Below is the soap response for DecryptData operation of Decrypt service. https://svc72.magensa.net/DecryptV3/Decrypt.svc?wsdl

DecryptData Response

<s:Envelope xmlns:s=\"http://schemas.xmlsoap.org/soap/envelope/\">\n       <s:Body>\n          <DecryptDataResponse xmlns=\"http://tempuri.org/\">\n            <DecryptDataResult xmlns:a=\"http://schemas.datacontract.org/2004/07/Decrypt.Core\" xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\">\n                <a:CustomerTransactionId/>\n                <a:IsReplay>true</a:IsReplay>\n                <a:MagTranId>2c193b5c-de38-43d5-bc3b-73f34b812ea2</a:MagTranId>                <a:DecryptedData>FC820102F28200FE820239008E1200000000000000004203440341031E031F035F24031909305F25031711019F0607A00000000410109F0702FFC09F0D05BC50BC08009F0E0500000000009F0F05BC70BC98009F10120210600003220000000000000000000000FF9F2608B4E47438FF561F5B9F2701409F36020003950504000080009B02E8009C01009F33032028C89F34031E03009F3704486F61809F400572\n0000B0015A0853256148000134559F02060000000015009F03060000000000009F1A02084057135325614800013455D19092010010005410000F8A0230309F10120210600003220000000000000000000000FF50104465626974204D6173746572436172640000</a:DecryptedData>\n             </DecryptDataResult>\n          </DecryptDataResponse>\n       </s:Body>\n    </s:Envelope>\n\n

GenerateMac

A command used to generate a MAC (Message Authentication Code) against a data block.

Input Properties

The GenerateMac operation request has below Input properties.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Property	Value	Description
BillingLabel		A user selected value that can be included in Reports or Requests. Max length of 64 characters.
CustomerTransactionID		A user selected value that can be included in Reports or Requests. Max length of 256 characters.
CustomerCode *		Customer code provided by Magensa at onboard time.
Password *		Password credential provided by Magensa at onboard time.
UserName *		User name credential provided by Magensa at onboard time.
DataToMAC*		Encrypted data block cryptogram in Hexadecimal format in multiples of 8 byte blocks (16 characters per block).
KSN *		Key Serial Number of the reader
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

Note: * = Required

Output Properties

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Property	Value	Description
CustomerTransactionID		Customer transaction ID
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.
MagTranId		Transaction ID in GUID alpha numeric form.
MACedString		MAC bytes (16 Hex characters)

GenerateMac 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.

GenerateMac Request

<soapenv:Header/>\n<soapenv:Body>\n<tem:GenerateMac>\n<tem:request>\n<dec:BillingLabel>BillingLabel</dec:BillingLabel>            <dec:CustomerTransactionID>CustomerTransactionID</dec:CustomerTransactionID>\n<dec:Authentication><dec:CustomerCode>customercode</dec:CustomerCode>\n<dec:Password>password</dec:Password>\n<dec:Username>username</dec:Username>\n</dec:Authentication>            sedec:DataToMAC>343031323334353637383930394439383700000000000000</dec:DataToMAC>\n<dec:KSN>9010010B31ED13000001</dec:KSN>\n<dec:KeyDerivationType>DUKPT</dec:KeyDerivationType>\n</tem:request>\n</tem:GenerateMac>\n</soapenv:Body>\n</soapenv:Envelope>\n\n

GenerateMac Response

<s:Envelope xmlns:s=\"http://schemas.xmlsoap.org/soap/envelope/\">\n   <s:Body>\n      <GenerateMacResponse xmlns=\"http://tempuri.org/\">\n         <GenerateMacResult xmlns:a=\"http://schemas.datacontract.org/2004/07/Decrypt.Core\" xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\">\n            <a:CustomerTransactionId>CustomerTransactionID</a:CustomerTransactionId>\n            <a:IsReplay>true</a:IsReplay>\n            <a:MagTranId>00350c72-23bf-4da6-9bb7-b4804889f4df</a:MagTranId>\n            <a:MACedString>2F19A27110AA871E</a:MACedString>\n         </GenerateMacResult>\n</GenerateMacResponse>\n   </s:Body>\n</s:Envelope>\n\n

DecryptCardSwipe

A command used to decrypt card swipes.

Input Properties

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Property	Value	Property Description
BillingLabel		A user selected value that can be included in Reports or Requests. Max length of 64 characters.
CustomerTransactionID		A user selected value that can be included in Reports or Requests. Max length of 256 characters.
CustomerCode *		Customer code provided by Magensa at onboard time.
Password *		Password credential provided by Magensa at onboard time.
UserName *		User name credential provided by Magensa at onboard time.
DeviceSN		Device serial number of the reader
KSN *		Key serial number of the reader
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
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.
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.
Track1		Encrypted Track 1 data in Hexadecimal format in multiples of 8 byte blocks (16 characters per block).
Track2 *		Encrypted Track 2 data in Hexadecimal format in multiples of 8 byte blocks (16 characters per block).
Track3		Encrypted Track 3 data in Hexadecimal format in multiples of 8 byte blocks (16 characters per block).

Note: * = Required

Output Properties

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Property	Value	Property Description
CustomerTransactionID		Customer transaction ID
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.
MagTranId		Transaction ID in GUID alpha numeric form.
CardID		Hashed CardID.
MagnePrint		MagnePrint decrypted value.
Track1		Decrypted Track 1 data.
Track2		Decrypted Track 2 data.
Track3		Decrypted Track 3 data.
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.

The Web Services Description Language URL for consuming this web service may be located at: https://svc72.magensa.net/DecryptV3/Decrypt.svc?wsdl

DecryptCardSwipe Request

<soapenv:Envelope xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\" xmlns:dec=\"http://schemas.datacontract.org/2004/07/Decrypt.Core\" xmlns:tem=\"http://tempuri.org/\">\n   <soapenv:Header />\n   <soapenv:Body>\n      <tem:DecryptCardSwipe>\n         <comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n         <tem:request>\n            <comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n            <dec:BillingLabel>0</dec:BillingLabel>\n            <comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n            <dec:CustomerTransactionID>0</dec:CustomerTransactionID>\n            <dec:Authentication>\n               <comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n               <dec:CustomerCode>customercode</dec:CustomerCode>\n               <comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n               <dec:Password>password</dec:Password>\n               <comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n               <dec:Username>username</dec:Username>\n            </dec:Authentication>\n           <dec:EncryptedCardSwipe>\n               <comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n               <dec:DeviceSN>B487DA9022119AA</dec:DeviceSN>\n               <dec:KSN>9011400B487DA9000007</dec:KSN>\n               <comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n               <dec:KeyType>Pin</dec:KeyType>\n               <comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n               <dec:MagnePrint>A4C4870970E452710FCBFD6D3388ECC2121D4B28A0282DEA7523A5E9470B6B731D28AE31A7C828B89E684A7413006EA5AB0BC4B51F74EBAC</dec:MagnePrint>\n               <comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n               <dec:MagnePrintStatus>61401400</dec:MagnePrintStatus>\n               <comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n               <dec:Track1>54EE1021145099EC55772C6C00B0D3CE6BCE1B0266E6483FD76F80243AE91286596AD0761840B731EC9A2168BB6943B3BE5FE7E605EF732122DC852E14DEF760BB40CBFE2F4B91AB</dec:Track1>\n               <comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n               <dec:Track2>B156DB6D856FA0592C0C3029745053F9C1701836FB35B87E091BEE77E9446E97B86DD0D1CD5597D8</dec:Track2>\n               <comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Optional:       -->\n               <dec:Track3 />\n            </dec:EncryptedCardSwipe>\n         </tem:request>\n      </tem:DecryptCardSwipe>\n   </soapenv:Body>\n</soapenv:Envelope>\n\n

DecryptCardSwipe Response

<s:Envelope xmlns:s=\"http://schemas.xmlsoap.org/soap/envelope/\">\n<s:Body>\n<DecryptCardSwipeResponse xmlns=\"http://tempuri.org/\">\n<DecryptCardSwipeResult xmlns:a=\"http://schemas.datacontract.org/2004/07/Decrypt.Core\" xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\">\n<a:CustomerTransactionId>0</a:CustomerTransactionId>\n<a:IsReplay>true</a:IsReplay>\n<a:MagTranId>7fe9fb87-9220-4aa0-b5cb-5a003829132f</a:MagTranId>            <a:CardID>uISJfty0btbZIRbjfwLWjMrdOl0Es+r4LjGqZh45U1E=</a:CardID>\n<a:DecryptedCardSwipe>               <a:MagnePrint>020020882CDC25063DA83890AB3E736FC7879F510AEBFD6F150B4D87D8B94E9BCDE760932E0CED36C0702909E6D03808DF16D0026ACE0000</a:MagnePrint><a:Track1>%B5325614800013455^CONTACTLESS/MAGTEK D^190920100100OP      00669000000?</a:Track1>\n        <a:Track2>;5325614800013455=19092010010066910000?</a:Track2>               <a:Track3/>\n</a:DecryptedCardSwipe><a:MagnePrintScore>0.7584068</a:MagnePrintScore></DecryptCardSwipeResult>\n</DecryptCardSwipeResponse>\n</s:Body>\n</s:Envelope>\n\n

Status Codes and Messages

Status Codes and Messages returned by Magensa for Decrypt 3.0 Operations.

Internal errors

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Code	StatusMsg	Notes
5000	Unknown Error

Input Validation Errors

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Code	StatusMsg
601	EncryptedData is required
602	KSN is required
603	CustomerCode is required
604	Username is required
605	Password is required
606	EncryptedData is not valid	Either the value was not HEX, not multiple of 16 characters, or the value was too long.
607	KSN is not valid	Either the value was not HEX, or the value was too long.
608	DataToMac is required
610	Track2 is required
611	MagnePrint is required
612	Track2 is not valid	Either the value was not HEX, not multiple of 16 characters, or the value was too long.
613	MagnePrint is not valid	Either the value was not HEX, not multiple of 16 characters, or the value was too long.
614	MagnePrint Status is required
615	CustomerTransactionID is not valid	Occurs if the length is more than 256 characters.
616	BillingLabel is not valid	Occurs if the length is more than 64 characters.
655	Track1 is not valid	Either the value was not HEX, not multiple of 16 characters, or the value was too long.
656	Track3 is not valid	Either the value was not HEX, not multiple of 16 characters, or the value was too long.
657	DataToMAC is not valid	Either the value was not HEX, not multiple of 16 characters, or the value was too long.

Other Errors

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Code	StatusMsg		Notes
701	Access Denied
702	Device Not Allowed
706	KSID Access Denied

","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Decrypt 3.0 Operations","slug":"decrypt-30-operations"},{"content":"Status Codes and Messages","slug":"status-codes-and-messages"}],"owner":"33729815","collectionId":"3aca5533-1682-443d-8279-42fc89728088","publishedId":"2sAYdkJVAe","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-03-05T16:20:44.000Z"},"item":[{"name":"DecryptCardSwipe","id":"ced755e4-8a2b-4580-8314-1512cd9e8ef0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n\t\"BillingLabel\":\"\",\r\n\t\"CustomerTransactionID\":\"\",\r\n\t\"Authentication\":{\r\n\t\t\"CustomerCode\":\"\",\r\n\t\t\"Password\":\"\",\r\n\t\t\"Username\":\"\"\r\n\t},\r\n\t\"EncryptedCardSwipe\":{\r\n\t\t\"DeviceSN\":\"\",\r\n\t\t\"EncryptionType\":\"\",\r\n\t\t\"KSN\":\"\",\r\n\t\t\"MagnePrint\":\"\",\r\n\t\t\"MagnePrintEncryptionType\":\"\",\r\n\t\t\"MagnePrintKSN\":\"\",\r\n\t\t\"MagnePrintStatus\":\"\",\r\n\t\t\"Track1\":\"\",\r\n\t\t\"Track2\":\"\",\r\n\t\t\"Track3\":\"\"\r\n\t}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://svc2.magensa.net/DecryptV3/Decrypt.svc/JSON/DecryptCardSwipe","urlObject":{"path":["DecryptCardSwipe"],"host":["https://svc2.magensa.net/DecryptV3/Decrypt.svc/JSON"],"query":[],"variable":[]}},"response":[{"id":"fe9f01bd-0fdf-4e8c-95c3-b3669f54a017","name":"DecryptCardSwipe","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"BillingLabel\": \"MyBillingLabel\",\r\n \"CustomerTransactionID\": \"1234567890\",\r\n \"Authentication\": {\r\n \"CustomerCode\": \"{{CustomerCode}}\",\r\n \"Password\": \"{{Password}}\",\r\n \"Username\": \"{{Username}}\"\r\n },\r\n \"EncryptedCardSwipe\": {\r\n \"DeviceSN\": \"B476F1F\",\r\n \"EncryptionType\": \"81\",\r\n \"KSN\": \"9011400B476F1F0001D2\",\r\n \"MagnePrint\": \"2F9CD700D06D86DD16BBB86D8ED05E6F0845148E663EA0290D78D0E90CBBD03833D450AA933DEEEC01886FD0C0D3578A7847735AEC19D010\",\r\n \"MagnePrintEncryptionType\": \"81\",\r\n \"MagnePrintKSN\": \"9011400B476F1F0001D2\",\r\n \"MagnePrintStatus\": \"61401000\",\r\n \"Track1\": \"454E1451495281088E2987C63AE6B62BE65B5EA3122767648001EE31F6A3668BA5097C9AEB6340F279B6326B2B2DD551F015DA9BAE9A0302927F711C7558934EE3CD8F39C9DF986FD17D3D8E1B10888B\",\r\n \"Track2\": \"5BEC7847993F1AE1413A046C5B3FE53E5F9454BCF23943BFB90DB28AB96F52B247822B390F40DEA0\",\r\n \"Track3\": \"\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://svc2.magensa.net/DecryptV3/Decrypt.svc/JSON/DecryptCardSwipe"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"ced755e4-8a2b-4580-8314-1512cd9e8ef0"},{"name":"DecryptData","id":"0234491b-141c-4d3b-a7c6-3522744d5748","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n\t\"BillingLabel\":\"\",\r\n\t\"CustomerTransactionID\":\"\",\r\n\t\"Authentication\":{\r\n\t\t\"CustomerCode\":\"\",\r\n\t\t\"Password\":\"\",\r\n\t\t\"Username\":\"\"\r\n\t},\r\n\t\"EncryptedData\":\"\",\r\n\t\"EncryptionType\":\"\",\r\n\t\"KSN\":\"\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://svc2.magensa.net/DecryptV3/Decrypt.svc/JSON/DecryptData","urlObject":{"path":["DecryptData"],"host":["https://svc2.magensa.net/DecryptV3/Decrypt.svc/JSON"],"query":[],"variable":[]}},"response":[{"id":"ff09273f-7ba6-4d9e-993f-734e8fe75c0e","name":"DecryptData","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n\t\"BillingLabel\":\"MyBillingLabel\",\r\n\t\"CustomerTransactionID\":\"1234567890\",\r\n\t\"Authentication\":{\r\n\t\t\"CustomerCode\":\"{{CustomerCode}}\",\r\n\t\t\"Password\":\"{{Password}}\",\r\n\t\t\"Username\":\"{{Username}}\"\r\n\t},\r\n\t\"EncryptedData\":\"8E338E6351DABF298DC9F88532E3865146C7072D89D048D9D566AD5EF77628475AC6AFD1811C3AA2\",\r\n\t\"EncryptionType\":\"80\",\r\n\t\"KSN\":\"FF002629159014E00054\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://svc2.magensa.net/DecryptV3/Decrypt.svc/JSON/DecryptData"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"0234491b-141c-4d3b-a7c6-3522744d5748"},{"name":"GenerateMAC","id":"88051bba-6e8e-44d4-bdc0-7fbd2258e190","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n\t\"BillingLabel\":\"\",\r\n\t\"CustomerTransactionID\":\"\",\r\n\t\"Authentication\":{\r\n\t\t\"CustomerCode\":\"\",\r\n\t\t\"Password\":\"\",\r\n\t\t\"Username\":\"\"\r\n\t},\r\n\t\"DataToMAC\":\"\",\r\n\t\"EncryptionType\":\"\",\r\n\t\"KSN\":\"\",\r\n\t\"KeyDerivationType\":\r\n}","options":{"raw":{"language":"json"}}},"url":"https://svc2.magensa.net/DecryptV3/Decrypt.svc/JSON/GenerateMAC","urlObject":{"path":["GenerateMAC"],"host":["https://svc2.magensa.net/DecryptV3/Decrypt.svc/JSON"],"query":[],"variable":[]}},"response":[{"id":"eaf97e51-80fb-4b0c-a288-bf05bb6f1ca4","name":"GenerateMAC","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n\t\"BillingLabel\":\"MyBillingLabel\",\r\n\t\"CustomerTransactionID\":\"1234567890\",\r\n\t\"Authentication\":{\r\n\t\t\"CustomerCode\":\"{{CustomerCode}}\",\r\n\t\t\"Password\":\"{{Password}}\",\r\n\t\t\"Username\":\"{{Username}}\"\r\n\t},\r\n\t\"DataToMAC\":\"42333145443133313230383135414100\",\r\n\t\"EncryptionType\":\"82\",\r\n\t\"KSN\":\"9010010B31ED13000001\",\r\n\t\"KeyDerivationType\":1\r\n}","options":{"raw":{"language":"json"}}},"url":"https://svc2.magensa.net/DecryptV3/Decrypt.svc/JSON/GenerateMAC"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"88051bba-6e8e-44d4-bdc0-7fbd2258e190"}],"event":[{"listen":"prerequest","script":{"id":"598ad45c-aa8f-41ab-8d8b-a62582d29d14","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"041f2777-bed7-4037-a1ae-cc62d3a6eb3f","type":"text/javascript","packages":{},"exec":[""]}}],"variable":[{"key":"baseUrl","value":"https://svc2.magensa.net/DecryptV3/Decrypt.svc/JSON","type":"string"}]}