Transact3 Web Service

Transact3

Click here for a complete list of operations.

ProcessCreditCard

Process ePayment Credit Card Transaction. (See result codes, below.)
Valid input values are:

UserName
& Password

:
:

Assigned by the payment gateway

TransType

CardNum

Payment Card Number

ExpDate

Payment Card Expiration Date in MMYY format

MagData

Payment Card Track II Mag-Stripe Data

NameOnCard

Cardholders Name

Amount

Amount in DDDDD.CC format

InvNum

Invoice Tracking Number

PNRef

Reference Number Assigned by the payment gateway

Zip

CardHolder's billing ZipCode used with AVS

Street

CardHolder's billing Street Address used with AVS

CVNum

CardHolder's Card Verification Number used with CV Check

ExtData

Extended Data in XML. Valid input values are:

CustomerIDAuthCode	:	Original Authorization Code
EntryMode	:	CardNum source: Manual \| MagneticStripe \| ICC \| Proximity
CVPresence	:	CVNum presence: None \| NotSubmitted \| Submitted \| Illegible \| NotPresent
CustCode	:	Customer Code used with Commercial Cards
TipAmt	:	Tip Amount
TaxAmt	:	Tax Amount used with Commercial Cards
SequenceNum	:	Sequence Number used with Recurring Transactions
SequenceCount	:	Sequene Count used with Recurring Transactions
ServerID	:	Server ID
Timeout	:	Timeout Value in Seconds (default=40)
TrainingMode	:	Training Mode: T or F
Force	:	Force Duplicates: T or F
RegisterNum	:	Register Number
PONum	:	Purhcase Order Number
City	:	the City of the CardHolder's billing address
BillPayment	:	Bill payment indicator: T or F

Authentication	:	Verified by Visa and UCAF programs: \|
Invoice	:	Purchase Card Level III
Fleet	:	Fleet card identification data
Items	:	Item data support for Fuel
IIAS_Indicator	:	(FSA/HRA support) Support for qualified healthcare purchase: T \| F
Partial_Indicator	:	(FSA/HRA support) Support for partial authorizations: T \| F
QHP_Amount	:	(FSA/HRA support) Optional qualified medical expenses (over the counter medical items) subtotal
RX_Amount	:	(FSA/HRA support) Optional prescription/RX subtotal
Vision_Amount	:	(FSA/HRA support) Optional Vision/Optical subtotal
Dental_Amount	:	(FSA/HRA support) Optional Dental subtotal
Clinical_Amount	:	(FSA/HRA support) Optional Clinical subtotal

SecureFormat	:	Encryption format: SecureMag \| SecureMagV2 \| MagneSafeV1 \| MagneSafeV2
SecurityInfo	:	Key Serial Number generated by secure card reader
Track1	:	Encrypted Track1 data
Track2	:	Encrypted Track2 data

Result Code	Value	Description
Success	0	Transaction was successful.
Fail	1	Transaction failed.
Reject	2	Transaction was rejected by processor.
Unknown	99	Unknown Transaction Failure.
DecryptionFailure	501	Unable to decrypt secure transaction due to invalid data or invalid decryption keys.
UnregisteredKSID	502	Secure device's ID is not registered as a SecureLink device.
InvalidSecureFormat	503	Unrecognized or missing SecureFormat in ExtData.
InvalidSecureTrack1	504	Invalid or missing Track1 in ExtData.
InvalidSecureTrack2	505	Invalid or missing Track2 in ExtData.
InvalidSecurityInfo	506	Invalid or missing SecurityInfo in ExtData.
NeedSecureLinkAccount	507	User is not authorized for SecureLink transactions
NeedSecureLinkEULA	508	User has not yet signed the SecureLink license agreement.
InvalidDecryptedTrack1	509	Track1 decrypted OK but is malformed. Causes: Invalid decryption keys or SecureFormat.
InvalidDecryptedTrack2	510	Track2 decrypted OK but is malformed. Causes: Invalid decryption keys or SecureFormat.

Test

To test the operation using the HTTP POST protocol, click the 'Invoke' button.

Parameter	Value
UserName:
Password:
TransType:
CardNum:
ExpDate:
MagData:
NameOnCard:
Amount:
InvNum:
PNRef:
Zip:
Street:
CVNum:
ExtData:

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /SmartPayments/transact3.asmx HTTP/1.1
Host: gateway.itstgate.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://TPISoft.com/SmartPayments/ProcessCreditCard"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ProcessCreditCard xmlns="http://TPISoft.com/SmartPayments/">
      <UserName>string</UserName>
      <Password>string</Password>
      <TransType>string</TransType>
      <CardNum>string</CardNum>
      <ExpDate>string</ExpDate>
      <MagData>string</MagData>
      <NameOnCard>string</NameOnCard>
      <Amount>string</Amount>
      <InvNum>string</InvNum>
      <PNRef>string</PNRef>
      <Zip>string</Zip>
      <Street>string</Street>
      <CVNum>string</CVNum>
      <ExtData>string</ExtData>
    </ProcessCreditCard>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ProcessCreditCardResponse xmlns="http://TPISoft.com/SmartPayments/">
      <ProcessCreditCardResult>
        <Result>int</Result>
        <RespMSG>string</RespMSG>
        <Message>string</Message>
        <Message1>string</Message1>
        <Message2>string</Message2>
        <AuthCode>string</AuthCode>
        <PNRef>string</PNRef>
        <HostCode>string</HostCode>
        <HostURL>string</HostURL>
        <ReceiptURL>string</ReceiptURL>
        <GetAVSResult>string</GetAVSResult>
        <GetAVSResultTXT>string</GetAVSResultTXT>
        <GetStreetMatchTXT>string</GetStreetMatchTXT>
        <GetZipMatchTXT>string</GetZipMatchTXT>
        <GetCVResult>string</GetCVResult>
        <GetCVResultTXT>string</GetCVResultTXT>
        <GetGetOrigResult>string</GetGetOrigResult>
        <GetCommercialCard>string</GetCommercialCard>
        <WorkingKey>string</WorkingKey>
        <KeyPointer>string</KeyPointer>
        <ExtData>string</ExtData>
      </ProcessCreditCardResult>
    </ProcessCreditCardResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /SmartPayments/transact3.asmx HTTP/1.1
Host: gateway.itstgate.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>
    <ProcessCreditCard xmlns="http://TPISoft.com/SmartPayments/">
      <UserName>string</UserName>
      <Password>string</Password>
      <TransType>string</TransType>
      <CardNum>string</CardNum>
      <ExpDate>string</ExpDate>
      <MagData>string</MagData>
      <NameOnCard>string</NameOnCard>
      <Amount>string</Amount>
      <InvNum>string</InvNum>
      <PNRef>string</PNRef>
      <Zip>string</Zip>
      <Street>string</Street>
      <CVNum>string</CVNum>
      <ExtData>string</ExtData>
    </ProcessCreditCard>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
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>
    <ProcessCreditCardResponse xmlns="http://TPISoft.com/SmartPayments/">
      <ProcessCreditCardResult>
        <Result>int</Result>
        <RespMSG>string</RespMSG>
        <Message>string</Message>
        <Message1>string</Message1>
        <Message2>string</Message2>
        <AuthCode>string</AuthCode>
        <PNRef>string</PNRef>
        <HostCode>string</HostCode>
        <HostURL>string</HostURL>
        <ReceiptURL>string</ReceiptURL>
        <GetAVSResult>string</GetAVSResult>
        <GetAVSResultTXT>string</GetAVSResultTXT>
        <GetStreetMatchTXT>string</GetStreetMatchTXT>
        <GetZipMatchTXT>string</GetZipMatchTXT>
        <GetCVResult>string</GetCVResult>
        <GetCVResultTXT>string</GetCVResultTXT>
        <GetGetOrigResult>string</GetGetOrigResult>
        <GetCommercialCard>string</GetCommercialCard>
        <WorkingKey>string</WorkingKey>
        <KeyPointer>string</KeyPointer>
        <ExtData>string</ExtData>
      </ProcessCreditCardResult>
    </ProcessCreditCardResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP GET

The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.

GET /SmartPayments/transact3.asmx/ProcessCreditCard?UserName=string&Password=string&TransType=string&CardNum=string&ExpDate=string&MagData=string&NameOnCard=string&Amount=string&InvNum=string&PNRef=string&Zip=string&Street=string&CVNum=string&ExtData=string HTTP/1.1
Host: gateway.itstgate.com

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<Response xmlns="http://TPISoft.com/SmartPayments/">
  <Result>int</Result>
  <RespMSG>string</RespMSG>
  <Message>string</Message>
  <Message1>string</Message1>
  <Message2>string</Message2>
  <AuthCode>string</AuthCode>
  <PNRef>string</PNRef>
  <HostCode>string</HostCode>
  <HostURL>string</HostURL>
  <ReceiptURL>string</ReceiptURL>
  <GetAVSResult>string</GetAVSResult>
  <GetAVSResultTXT>string</GetAVSResultTXT>
  <GetStreetMatchTXT>string</GetStreetMatchTXT>
  <GetZipMatchTXT>string</GetZipMatchTXT>
  <GetCVResult>string</GetCVResult>
  <GetCVResultTXT>string</GetCVResultTXT>
  <GetGetOrigResult>string</GetGetOrigResult>
  <GetCommercialCard>string</GetCommercialCard>
  <WorkingKey>string</WorkingKey>
  <KeyPointer>string</KeyPointer>
  <ExtData>string</ExtData>
</Response>

HTTP POST

The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /SmartPayments/transact3.asmx/ProcessCreditCard HTTP/1.1
Host: gateway.itstgate.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

UserName=string&Password=string&TransType=string&CardNum=string&ExpDate=string&MagData=string&NameOnCard=string&Amount=string&InvNum=string&PNRef=string&Zip=string&Street=string&CVNum=string&ExtData=string

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<Response xmlns="http://TPISoft.com/SmartPayments/">
  <Result>int</Result>
  <RespMSG>string</RespMSG>
  <Message>string</Message>
  <Message1>string</Message1>
  <Message2>string</Message2>
  <AuthCode>string</AuthCode>
  <PNRef>string</PNRef>
  <HostCode>string</HostCode>
  <HostURL>string</HostURL>
  <ReceiptURL>string</ReceiptURL>
  <GetAVSResult>string</GetAVSResult>
  <GetAVSResultTXT>string</GetAVSResultTXT>
  <GetStreetMatchTXT>string</GetStreetMatchTXT>
  <GetZipMatchTXT>string</GetZipMatchTXT>
  <GetCVResult>string</GetCVResult>
  <GetCVResultTXT>string</GetCVResultTXT>
  <GetGetOrigResult>string</GetGetOrigResult>
  <GetCommercialCard>string</GetCommercialCard>
  <WorkingKey>string</WorkingKey>
  <KeyPointer>string</KeyPointer>
  <ExtData>string</ExtData>
</Response>