Github resources: https://github.com/Magensa/DAFv4
\nPlayground: https://demo.magensa.net/Dafplayground/ClientApp/build
\nEndpoint URLs:
\nThe purpose of this document is to provide a description of how to call operations of the Magensa Decrypt and Forward 4.0 Web Services.
\nEffective use of the Decrypt and Forward Web Services enables users to easily integrate encrypted card swipe data into a payment application where the payment application traditionally transmits unencrypted card swipe data when calling web services for a third-party (or ‘target’) service provider.
\nUsers can send Magensa the encapsulated XML (SOAP) or key-value pairs for the third-party service provider, along with encrypted card swipe data from a MagTek MagneSafe reader, and Magensa will decrypt the card swipe data and insert the relevant data, including the unencrypted card data, into the target XML or key-value pairs and call the third-party service provider on behalf of the user. This process will allow a user to support encrypted card swipe data in their payment application without the third-party service provider supporting a decryption service.
\nFigure 1 - Decrypt and Forward
\nExamples of third-party service providers to use with Decrypt and Forward:
\nPayment processors
\nTokenization services
\nCard fraud alert services
\nGift card processors
\nCredit check services
\nSpecial-purpose gateways (EBT, procurement card, etc)
\nThe Decrypt and Forward Web Service works by decrypting data from a MagneSafe encrypted card swipe and placing the appropriate decrypted data into the target XML or key-value pairs. This is accomplished by using “field replacement variables” that are inserted in-line into the payload. For instance, a target web service might accept a card Primary Account Number (PAN) as an input using the following tag:
\nTo instruct Magensa to place the decrypted PAN from the card swipe into this tag, the field replacement variable {CCNum} would be used as follows: {CCNum}
Variables
\n{DecryptedData}
{CCName}
{CCNum}
{CCTrack1}
{CCTrack1Length}
{CCTrack2}
{CCTrack2Length}
{CCardType}
{KSN}
{MMYYCCExpdt}
{MM_YYCCExpdt}
{DD}
{MM}
{YY}
{YYYY}
{DecryptedBlob}
Additional variables will be added from time-to-time. If a particular card data element is required for the target web service you wish to use, please contact support@magensa.net to submit a request to have it added to the service.
\nA unique, new feature introduced in Decrypt and Forward 4.0 is the ability to send a “batch” of requests in a single call to the service. As a result, all Decrypt and Forward 4.0 service operations take in an array of requests and return an array of responses. The service processes these input requests serially and a specific index/element of response corresponds to the specific index/element of request. All responses have a DecryptForwardFaultException element and in the case of an error or exception raised for that
\nparticular request, the details will be available in the corresponding DecryptForwardFaultException element. When successful, the value of this DecryptForwardFaultException element will be null.
\nThe Decrypt and Forward Web Services do not rely on a pre-existing integration between Magensa and the third-party service provider. As long as the third-party service provider uses web services, and Magensa can call those web services on behalf of the user, the third-party service can be used.
\nIn the case where the user has never integrated to the third-party service provider before, it is recommended for the user to integrate to the Decrypt and Forward Web Services first, and then certify to the target third-party service provider with Decrypt and Forward in-place.
\nIn order for Magensa to call the third-party service provider, consideration must be given to the following:
\nWhether Magensa’s IP addresses and domain names must be whitelisted with the third-party
\nWhether client and/or server-side certificates are required.
\nInformation in this document is subject to change without notice. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Magensa LLC.
\nA command used to decrypt and forward a processed card swipe.
\nNote: * = Required
\nThe Web Services Description Language URL for consuming this web service may be located at:
\nhttps://daf.magensa.net/v4/Service.svc?singleWsdl
\nA command used to process and forward a transaction. The transaction may be encrypted, non-encrypted, TLV encoded, or not TLV encoded based on the input properties.
\nNote: * = Required
\nThe Web Services Description Language URL for consuming this web service may be located at:
\nhttps://daf.magensa.net/v4/Service.svc?singleWsdl
\nA command used to process a token.
\nNote: * = Required
\nThe Web Services Description Language URL for consuming this web service may be located at:
\nhttps://daf.magensa.net/v4/Service.svc?singleWsdl
\nStatus Codes and Messages returned by Magensa for Decrypt and Forward 4.0 web service operations.
\nInternal errors
\nInput Validation errors
\nThe following functions can be used in conjunction with field variables in order to build processor payloads request. A space is not needed between commas which delimit the parameters, unless specifically need as part of the parameter. All parameters shall not be enclosed in quotations (“”).
\nThis function adds two numbers.
\n$Add(Operand1_Numeric,Operand2_Numeric,ToStringFormat_Optional)
\nReturn Value:
\nThe numeric sum of Operand1_Numeric and Operand2_Numeric.
\nThis function returns the current date and time.
\n$DateTimeNow(Optional_format,Optional_0_Local_Or_1_Universal)
\nReturn Value:
\nA string of the current date and time.
\nThis function converts a numeric value to an equivalent string.
\n$DecimalToString(Operand1_Numeric,ToStringFormat_Optional)
\nReturn Value:
\nA string equivalent of the Operand1_Numeric.
\nThis function finds the position of one string within another.
\n$IndexOf(string,searchString,startPosition,numberOfCharacterPosition)
\nReturn Value:
\nThe zero-based index position of value from the start of the current instance if that string is found, or -1 if it is not. If string is empty, the return value is startPosition.
\nThis function finds the position of one string within another and is case insensitive.
\n$IndexIgnoreCaseOf(string,searchString,startPosition,numberOfCharacterPosition)
\nReturn Value:
\nThe zero-based index position of value from the start of the current instance if that string is found, or -1 if it is not. If string is empty, the return value is startPosition.
\nThis function returns the number of characters in a string.
\n$Length(string)
\nReturn Value:
\nThe string length.
\nThis function multiplies two numbers.
\n$Multiply(Operand1_Numeric,Operand2_Numeric,ToStringFormat_Optional)
\nReturn Value:
\nThe product of Operand1_Numeric and Operand2_Numeric.
\nThis function replaces a substring within another string.
\n$Replace(string,oldValue,newValue)
\nReturn Value:
\nA string of which all instances of an oldValue substring has been replaced with a newValue substring.
\nThis function retrieves a substring of the source string.
\n$Substring(string,startindex,length)
\nReturn Value:
\nA string that is equivalent to the substring of specified length.
\nThis function returns the length of the data portion for a single TLV element string.
\n$TLVLength(string)
\nReturn Value:
\nThe hexadecimal data length of the TLV element.
\nThis function removes leading and trailing spaces from a string.
\n$Trim(string)
\nReturn Value:
\nA string without leading and trailing spaces.
\nThis function evaluates a regular expression to find a match in the input string.
\n$RegExIsMatch(InputString,patternString, RegexOptionsStringOptional)
\nReturn Value:
\n“True” string if the regular expression finds a match, otherwise returns “False”.
\nThis function replaces all strings that match a regular expression with a replacement string.
\n$RegExReplace(InputString,PatternString,ReplacementString,RegexOptionsStringOptional)
\nReturn Value:
\nA new string that is identical to the input string, except that the replacement string takes the place of each matched string. If pattern is not matched, the input string is returned.
\nThis function converts an expression into its unescaped form.
\n$RegExUnescape(InputString)
\nReturn Value:
\nA string of characters with any escaped characters converted to their unescaped form.
\nThis function evaluates an expression and returns either a true or false result string.
\n$Iif(ConditionBool,ResultTrueString,ReturnFalseStringOptional)
\nReturn Value:
\nThe True result string if the Boolean condition is true, otherwise the False result string.
\nThis function negates a Boolean value.
\n$NotBool(OperandBool)
\nReturn Value:
\n“True” string when OperandBool is false. “False” string when OperandBool is true.
\nThis function performs an AND operation on two Boolean values.
\n$AndBool(Operand1Bool,Operand2Bool)
\nReturn Value:
\n“True” string when both Operand1Bool and Operand2Bool are true, otherwise returns “False”.
\nThis function performs an OR operation on two Boolean values.
\n$OrBool(Operand1Bool,Operand2Bool)
\nReturn Value:
\n“True” string when both Operand1Bool and Operand2Bool are true,
\n“True” string when either Operand1Bool or Operand2Bool are true, otherwise returns “False”.
\nThis function checks if the source string contains a substring.
\n$IsContains(String,ContainsString,IgnoreCaseBool)
\nReturn Value:
\n“True” string when ContainsString is found, otherwise returns “False”.
\nThis function compares two strings.
\n$IsEqualStrings(Operand1String,Operand2String,IgnoreCaseBool)
\nReturn Value:
\n“True” string when Operand1String and Operand2String match, otherwise returns “False”.
\nThis function compares for the equality of two numbers.
\n$IsEqualNumbers(Operand1Number,Operand2Number)
\nReturn Value:
\n“True” string when Operand1Number and Operand2Number match, otherwise returns “False”.
\nThis function compares for the inequality of two numbers.
\n$IsGreaterOrEqual(Operand1Number,Operand2Number)
\nReturn Value:
\n“True” string when Operand1Number is greater than or equal to Operand2Number, otherwise returns “False”.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Additional References:","slug":"additional-references"},{"content":"Purpose of the document","slug":"purpose-of-the-document"},{"content":"Decrypt and Forward Version 4.0 Operations","slug":"decrypt-and-forward-version-40-operations"},{"content":"Status Codes and Messages","slug":"status-codes-and-messages"},{"content":"Template Functions","slug":"template-functions"}],"owner":"33729815","collectionId":"2bf1bb52-67d4-4ceb-b948-28ae7a36f37a","publishedId":"2sAYdkJVAf","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-03-05T16:22:45.000Z"},"item":[{"name":"ProcessCardSwipe","id":"db02d3e2-ab29-4eb6-80c7-b78adf96e0c4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"text/xml;charset=UTF-8"},{"key":"SOAPAction","value":"http://tempuri.org/IDecryptAndForward/ProcessCardSwipe"}],"body":{"mode":"raw","raw":"{\n\t\"Authentication\":{\n\t\t\"CustomerCode\":\"{{CustomerCode}}\",\n\t\t\"Password\":\"{{Password}}\",\n\t\t\"Username\":\"{{Username}}\"\n\t},\n\t\"CustomerTransactionID\":\"R - Customer Defined Field up to a 256 character string\",\n\t\"ProcessCardSwipeInputs\":[{\n\t\t\"AdditionalRequestData\":[{\n\t\t\t\t\"key\":\"