Submitting a Transaction

top top top

Processing Single Credit Card Transactions

This service is used when you want to make a single transaction by swiping a credit card through the magnetic stripe reader (MSR). This is when you want to do a one-off credit card transaction without needing a token (Customer Code) to be used or created.

To use the encrypted MSR for a single credit card transaction, you must use the ProcessLink “ProcessCreditCardV1” SOAP call. The encrypted data needs to be added to the creditCardNum field, below.

POST /NetGate/ProcessLink.asmx HTTP/1.1
Host: www.iatspayments.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
 <soap12:Body>
   <ProcessCreditCardV1 xmlns="https://www.iatspayments.com/NetGate/">
     <agentCode>string</agentCode>
     <password>string</password>
     <customerIPAddress>string</customerIPAddress>
     <invoiceNum>string</invoiceNum>
     <creditCardNum>string</creditCardNum>
     <creditCardExpiry>string</creditCardExpiry>
     <cvv2>string</cvv2>
     <mop>string</mop>
     <firstName>string</firstName>
     <lastName>string</lastName>
     <address>string</address>
     <city>string</city>
     <state>string</state>
     <zipCode>string</zipCode>
     <total>string</total>
     <comment>string</comment>
   </ProcessCreditCardV1>
 </soap12:Body>
</soap12:Envelope>

 

For example, the card read data from the ID Tech SecureMag would be:

<creditCardNum>00|@|02B701801F422300039B%*4111********1111^PAYMENTSTESTCARD/IATS^***********************?*;4111********1111=***************?*D9DC9EFFAC215F5997B6C8FE81559E4731349E73591F1985105FF001225A7B9D71783A7BB6B073F06578EA6C668F368FACCEA6EADD953818D3F3A6FE47EB580D1433D906FD732CCCC280D68B25E91342088970A55D138E2EAA59AF53C7C690924C67DCDB76419EAF661F5DF9749154D84855231220C06A05CA81AA62361BA02901DF2197F795D78CFA64FA48CF0624FA81CA32573681E4F1FFFF7381390005A00003225803</creditCardNum>

Processing a Credit Card & Creating a Token

This service is for when you want to create a credit card token (Customer Code) (Note: no recurring transactions will be set up with this process) and to process a credit card transaction at the same time. This is useful if you want to do an immediate transaction, but store the token for future transactions without need to store the clear text credit card details.

To use the encrypted swipe feature, you need to first write the code to process a single credit card transaction using ProcessLink, “CreateCustomerCodeAndProcessCreditCardV1” instructions. The encrypted data needs to be added to the ccNum field, highlighted below.

 

POST /NetGate/ProcessLink.asmx HTTP/1.1
Host: www.iatspayments.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
 <soap12:Body>
   <CreateCustomerCodeAndProcessCreditCardV1 xmlns="https://www.iatspayments.com/NetGate/">
     <agentCode>string</agentCode>
     <password>string</password>
     <customerIPAddress>string</customerIPAddress>
     <invoiceNum>string</invoiceNum>
     <ccNum>string</ccNum>
     <ccExp>string</ccExp>
     <firstName>string</firstName>
     <lastName>string</lastName>
     <address>string</address>
     <city>string</city>
     <state>string</state>
     <zipCode>string</zipCode>
     <cvv2>string</cvv2>
     <total>string</total>
   </CreateCustomerCodeAndProcessCreditCardV1>
 </soap12:Body>
</soap12:Envelope>

 

For example, the card read data from the ID Tech UniMag II would be:

<ccNum>01|@|02f00080 1f422300 8383252a 34313131 2a2a2a2a 2a2a2a2a 31313131 5e504159 4d454e54 53544553 54434152 442f4941 54535e32 3130382a 2a2a2a2a 2a2a2a2a 2a2a2a2a 2a2a2a2a 2a2a3f2a 3b343131 312a2a2a 2a2a2a2a 2a313131 313d3231 30382a2a 2a2a2a2a 2a2a2a2a 2a3f2a87 a8e39cfa b3ef0630 ee27e912 34ce82d8 5b689e5f 10365a78 4c7573d2 1398ac9d 9cc2cd87 5e05ba1f 4e845ee0 306cf707 ae02a247 b2cab73a 46a2b203 df559488 433d3c14 a769b2c4 244829c4 97dbffc2 3890bd8e 1373fb2c 56706162 e6a4fd03 23be5966 9ff8bd73 71634a4c 2c3d4254 31343032 36333335 33ffff73 81390314 800007c8 2403</ccNum>

Creating Token Only

This service is used when you do not want to process a transaction immediately, but only create a token to store on your dbase. This token can then be used for single transactions or recurring transactions where you manage the recurring schedule.

The SOAP service call for this will use the CustomerLink “CreateCreditCardCustomerCodeV1” SOAP call.

 

POST /NetGate/CustomerLink.asmx HTTP/1.1
Host: www.iatspayments.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
 <soap12:Body>
   <CreateCreditCardCustomerCodeV1 xmlns="https://www.iatspayments.com/NetGate/">
     <agentCode>string</agentCode>
     <password>string</password>
     <customerIPAddress>string</customerIPAddress>
     <customerCode>string</customerCode>
     <firstName>string</firstName>
     <lastName>string</lastName>
     <companyName>string</companyName>
     <address>string</address>
     <city>string</city>
     <state>string</state>
     <zipCode>string</zipCode>
     <phone>string</phone>
     <fax>string</fax>
     <alternatePhone>string</alternatePhone>
     <email>string</email>
     <comment>string</comment>
     <recurring>Boolean</recurring>
     <amount>string</amount>
     <beginDate>dateTime</beginDate>
     <endDate>dateTime</endDate>
     <scheduleType>string</scheduleType>
     <scheduleDate>string</scheduleDate>
     <creditCardCustomerName>string</creditCardCustomerName>
     <creditCardNum>string</creditCardNum>
     <creditCardExpiry>string</creditCardExpiry>
     <mop>string</mop>
   </CreateCreditCardCustomerCodeV1>
 </soap12:Body>
</soap12:Envelope>

 

For example, the card read data from the MagTek uDynamo would be:

<creditCardNum>03|@|C4DDC3DE59B1DB65F03D04CFF145469CBB2CB59E22BA56ED8691D27813D963F51408F5BDDEB03E0B1860EFAAD85F9FA78ED32911443282D4ACE1F585C194DEE2D7F473456972ABB9|@|FADF1842439903BB07D444459D4DBEDC0EE099322D1AA7FBC64CDBFE834511632A592E52BFC8EE95|@|9012910B1D54BC000069</creditCardNum>

 

Notes: To create a token only, set the recurring flag to False. It is possible to set up a recurring schedule with this call as well by setting the recurring flag to True and supplying the amount, start and end dates, schedule type and schedule date. Refer to the iATS CustomerLink documents for further details on this.