General Info & Utilities

GetCardUpdates

Endpoint URL: https://secure.ftipgw.com/Admin/ws/TrxDetail.asmx?op=GetCardUpdates Method: Supports both SOAP POST and HTTP GET/POST (form‑encoded) Description Retrieves details of all card updates processed for a merchant within a specified date range, including updates like expiration date or account number changes reported by card updater services Request Parameters

Parameter

Type

Required

Description

UserName

string

Yes

User name assigned by the payment gateway frontstream.com+1secure.ftipgw.com+1

Password

string

Yes

Corresponding password

MerchantKey

string

Yes

Merchant’s key; the query runs against this merchant account

BeginDt

string

Yes

Start of date range (MM/DD/YYYY); auto‑converted to T00:00:00.0000AM

EndDt

string

Yes

End of date range (MM/DD/YYYY); auto‑converted to T12:59:59.9999PM

ExtData

string

Optional XML string for extended data

Notes

Response Format:
- Returns an XML payload containing one <Table> node per card update event secure.ftipgw.com+2frontstream.com+2secure.ftipgw.com+2.
Response Fields:
- Includes fields like <Card_Info_Key>, <AccountLastFour>, <Updated> (boolean), <ExpDate>, <UpdatedExpDate>, and <ResponseCodeTxt>, among others frontstream.com.
Response Codes:
- Codes such as 000 (New Card), 201 (Expiration Updated), 202 (Account Number Updated), 203 (Account Closed), etc. A complete code‑to‑text mapping is available in the documentation frontstream.com.
Date Handling:
- Input dates are normalized with explicit AM/PM boundaries (BeginDt at midnight start, EndDt just before midnight end).
Multiple Records:
- You may receive multiple <Table> entries—make sure parsing logic handles arrays of updates.
ExtData Usage:
- While optional, ExtData can be used to filter or enhance the request/response. Its exact format is provider‑specific XML.
Protocol Flexibility:
- This endpoint can be invoked via SOAP or simple HTTP GET/POST — choose based on your integration context

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 /Admin/ws/TrxDetail.asmx HTTP/1.1
Host: secure.ftipgw.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://demo.tpisoft.com/Admin/ws/GetCardUpdates"

<?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>
    <GetCardUpdates xmlns="http://demo.tpisoft.com/Admin/ws">
      <username>string</username>
      <password>string</password>
      <merchantKey>string</merchantKey>
      <beginDt>string</beginDt>
      <endDt>string</endDt>
      <extData>string</extData>
    </GetCardUpdates>
  </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>
    <GetCardUpdatesResponse xmlns="http://demo.tpisoft.com/Admin/ws">
      <GetCardUpdatesResult>string</GetCardUpdatesResult>
    </GetCardUpdatesResponse>
  </soap:Body>
</soap:Envelope>

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

POST /Admin/ws/TrxDetail.asmx/GetCardUpdates HTTP/1.1
Host: secure.ftipgw.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

username=string&password=string&merchantKey=string&beginDt=string&endDt=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"?>
<string xmlns="http://demo.tpisoft.com/Admin/ws">string</string>

GetCardType

Endpoint URL: https://secure.ftipgw.com/ArgoFire/validate.asmx?op=GetCardType

Method: SOAP (Action: GetCardType)

Description: Determines the type of a credit card (e.g., Visa, MasterCard, Discover, Amex) based on the card number provided. Intended for validation or routing decisions within ArgoFire-integrated flows.

Request Parameters:

Name

Type

Required

Description

CcAccountNum

string

Yes

Credit card number to evaluate

Notes:

Returns a string indicating the card brand (e.g., "Visa", "MC", "Amex").
No transaction or tokenization is performed — this is strictly a metadata lookup.
Often used for UI display or to conditionally apply rules before submission.
Ensure the card number is never logged or stored during this request.
This endpoint is part of the ArgoFire validation suite, and may differ slightly in behavior from the legacy version under /recurring.asmx.

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 /ArgoFire/validate.asmx HTTP/1.1
Host: secure.ftipgw.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://localhost/SmartPayments/GetCardType"

<?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>
    <GetCardType xmlns="http://localhost/SmartPayments/">
      <CardNumber>string</CardNumber>
    </GetCardType>
  </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>
    <GetCardTypeResponse xmlns="http://localhost/SmartPayments/">
      <GetCardTypeResult>string</GetCardTypeResult>
    </GetCardTypeResponse>
  </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 /ArgoFire/validate.asmx HTTP/1.1
Host: secure.ftipgw.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>
    <GetCardType xmlns="http://localhost/SmartPayments/">
      <CardNumber>string</CardNumber>
    </GetCardType>
  </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>
    <GetCardTypeResponse xmlns="http://localhost/SmartPayments/">
      <GetCardTypeResult>string</GetCardTypeResult>
    </GetCardTypeResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP POST

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

POST /ArgoFire/validate.asmx/GetCardType HTTP/1.1
Host: secure.ftipgw.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

CardNumber=string

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

<?xml version="1.0" encoding="utf-8"?>
<string xmlns="http://localhost/SmartPayments/">string</string>

GetInfo

Endpoint URL: https://secure.ftipgw.com/ArgoFire/transact.asmx?op=GetInfo

Method: SOAP (Action: GetInfo)

Description: Retrieves full details about a previously submitted transaction using its TransRefID. This is often used for reconciliation, auditing, or checking the status and metadata of a payment after the fact.

Request Parameters:

Name

Type

Required

Description

Username

string

Yes

API credential username

Password

string

Yes

API credential password

TransRefID

string

Yes

Unique transaction reference ID to look up

Notes:

Returns a full record of the transaction, including status, amounts, timestamps, card type, and custom fields.
The TransRefID is returned by most ArgoFire transaction calls (e.g., ProcessCreditCard, ProcessCheck).
This endpoint does not return sensitive card data (e.g., PAN or CVV).
Commonly used by backend systems to confirm success, capture metadata, or display results to admins.
Must be called with valid API credentials — not tied to a session or tokenization flow.

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 /ArgoFire/transact.asmx HTTP/1.1
Host: secure.ftipgw.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://TPISoft.com/SmartPayments/GetInfo"

<?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>
    <GetInfo xmlns="http://TPISoft.com/SmartPayments/">
      <UserName>string</UserName>
      <Password>string</Password>
      <TransType>string</TransType>
      <ExtData>string</ExtData>
    </GetInfo>
  </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>
    <GetInfoResponse xmlns="http://TPISoft.com/SmartPayments/">
      <GetInfoResult>
        <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>
      </GetInfoResult>
    </GetInfoResponse>
  </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 /ArgoFire/transact.asmx HTTP/1.1
Host: secure.ftipgw.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>
    <GetInfo xmlns="http://TPISoft.com/SmartPayments/">
      <UserName>string</UserName>
      <Password>string</Password>
      <TransType>string</TransType>
      <ExtData>string</ExtData>
    </GetInfo>
  </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>
    <GetInfoResponse xmlns="http://TPISoft.com/SmartPayments/">
      <GetInfoResult>
        <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>
      </GetInfoResult>
    </GetInfoResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP POST

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

POST /ArgoFire/transact.asmx/GetInfo HTTP/1.1
Host: secure.ftipgw.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

UserName=string&Password=string&TransType=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>

CaptureAll

Endpoint URL: https://secure.ftipgw.com/SmartPayments/transact.asmx?op=ProcessCreditCard

(Same as other ProcessCreditCard operations.)

Description: The CaptureAll operation closes and settles all approved credit card transactions in the merchant’s current open batch. It is used to submit the entire batch for settlement with a single call, rather than capturing individual transactions one by one.

Request Parameters

Parameter

Required

Description

UserName

Yes

The merchant’s API username.

Password

Yes

The merchant’s API password.

TransType

Yes

Must be set to CaptureAll.

Sample Request

<Request>
  <UserName>test</UserName>
  <Password>123</Password>
  <TransType>CaptureAll</TransType>
</Request>

Sample Response

<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xmlns="https://secure.ftipgw.com/ArgoFire/">
  <Result>0</Result>
  <RespMSG>Approved</RespMSG>
  <Message>ACCEPTED</Message>
  <AuthCode>GB00029 ACCEPTED</AuthCode>
  <ExtData>Net_Count=5,Net_Amount=275.00,Settle_DT=2004-04-13 15:36:26</ExtData>
</Response>

Result 0 = successful batch settlement
RespMSG / Message = confirmation that batch was closed and accepted
AuthCode = settlement confirmation reference
ExtData = provides batch statistics: total transaction count, total settled amount, and settlement date/time

ArgoFire Response Codes

These codes are returned for both credit card and ACH/check transactions.

Code

Meaning

Description

000

New Card

This is a new account.

200

Valid account, no update

No update from card brand.

201

Account Expiration Date Updated

Card brand updated expiration date.

202

Account Number Updated

Card brand updated the account number.

203

Account is Closed

Card brand reports account is closed.

204

Contact Cardholder

Card brand advises contacting the cardholder.

205

Error – Merchant Not Registered

Merchant not registered with card brand.

206

No Match

Card brand did not find a matching account.

207

Blocked Merchant / Fraud Reported

Merchant is blocked or reported for fraud.

208

Inactive Card

No activity in past 13 months.

209

Inactive / Canceled Seller

Merchant is inactive or canceled.

315

Invalid Expiration Date

Expiration date failed validation.

320

Invalid Account Number

Account number invalid per issuer.

329

Invalid Card Type

Supplied card type is invalid.

330

Remove Successful

Card account removal was successful.

336

Invalid or Blank Seller ID

Seller ID is missing or invalid.

339

Card Removed Previously

Card was already removed prior.

340

Card Record Not Found

No record exists for that card.

Example Usage

<Response>
  <ResponseCode>202</ResponseCode>
  <ResponseCodeTxt>Account Number Updated</ResponseCodeTxt>
</Response>

202 indicates: Account Number Updated
ResponseCodeTxt provides a text explanation.
Valid Input Characters

PreviousTokenization Services NextTransaction Types and Behaviors

Last updated 8 days ago