WebCheck Web Services Interface 2.0 August 2010 · TTech WebCheck Services Refund - Request Field Name Type Description MerchantID Integer TTech Assigned Merchant ID. RefundTransactionID

1

WebCheck

Web Services Interface

2.0

August 2010

2

T Tech WebCheck Services

Transaction Technologies, LLC (T Tech) WebCheck Services product extends to its customers

the option of processing electronic check payments through the industry standard common protocol

Web Services. Governed by the Web Services Interoperability Organization (WS-I), Web Services

permits information systems of varying technologies, both new and old, a means to communicate using

a common set of previously agreed upon rules. The shared rule set is based upon Web Services

Definition Language (WSDL), Simple Object Access Protocol (SOAP) and Extensible Markup

Language (XML)- a simple methodology used by information system professionals to structure and

exchange data.

By passing information back and forth through this simple structured language, T Tech supplies

its WebCheck Services product by the Software As A Service (SAAS) delivery model. The SAAS

business model relieves T Tech's customers of the burden to maintain their own secure payment

processing engines. WebCheck Services customers can instead rely confidently upon T Tech's

centralized system to process their check payments. In short, T Tech's WebCheck Services provides an

easy and cost effective technological pathway to a stable secure payment processing system with a long

history that has served millions of consumers.

WebCheck Services Basic Components

1. Simple ACH Authorization – Comprised of a real-time internet Authorization

transaction in which basic payment information is sent by the merchant to WebCheck

Services and a basic confirmation is returned back.

2. Authorization with Batch Out – Comprised of both the simple Authorization

transaction described above and an end-of-business-day Batch Out real-time internet

transaction. The end-of-business-day Batch Out transaction is sent by the merchant to

WebCheck Services as a means to further verify and give final approval of the payments

to be deposited. Fundamentally, the Batch Out transaction is a listing of all the

authorizations previously confirmed since the last deposit. WebCheck Services “double-

checks” each item in the listing. Then, WebCheck Services returns to the merchant a

listing of all payments confirmed for deposit. This additional Batch Out provides a

supplemental measure to manage and balance payment transactions.

3. WebCheck Reports – Comprised of a series of real-time online reports. All reports can

be downloaded in native format to Microsoft Excel.

(a) Pending Report – Lists all payments queued up for deposit. Payments can be

cancelled on demand by the merchant.

(b) Batch Out Report – Lists all Batch Out transactions submitted. Batch Out

batches can be cancelled and resubmitted if needed prior to deposit.

(c) Deposit Register – Lists all items within a day's deposit.

(d) Search – Online research tool for querying transactions.

4. Deposits – All payments are processed for deposit at 3:00PM Eastern Time.

5. Refunds – WebCheck Web Services Interface also includes a separate URL portal

through which Refunds may be processed for previously deposited WebCheck

payments.

3


Secure Data Center

WebCheck keeps its highly sensitive information securely nestled in a state-of-the-art data

center located in Houston, Texas. The Planet, Inc. owns and operates the information processing

center. T Tech specializes in payment processing. T Tech chose The Planet (www.ThePlanet.com) for

these basic purposes:

• It is a SAS/70 Type II data center- recognized as the best in the business

• It boasts itself as the industry’s most robust instantaneous network, with over 250 gbps of

transit and peering capacity from 7 tier-1 suppliers

• It offers industry-leading SLAs provide the assurances your business deserves

• It maintains 24x7x365 support for peace of mind

Secure Socket Layer (SSL) Encryption / Authentication

Perhaps unknowingly to the consumer, Secure Socket Layer (SSL) satisfies an elemental

component of Internet trust. When an individual purchases online goods and/or services, he/she may

notice that the letters HTTPS precede the domain name address in the Internet browser address bar up

toward the top of the browser. The “S” indicates “secure.” Furthermore, the “S” signifies that SSL

technology encrypts and authenticates the interaction between the browser and the web server, making

unreadable the transmission of the data from rogue thieves with mal intent. Netscape, Inc. developed

the original technology years ago. Today, all browsers and ecommerce web servers count on it. T Tech

encrypts all communication between WebCheck user browsers and WebCheck web servers.

Encrypted Checking Account

Beyond scrambling data during transmission, T Tech also encrypts the consumer checking

account information stored in its secure database system. Even in the unlikely event that someone or

something would penetrate T Tech, the intruder would not find anything of useful value.

4


Simple ACH Authorization -

Production: https://www.ttechpayments.net/WebCheckServices/ACHAuth?wsdl

Test: http://174.120.132.226/WebCheckServices/ACHAuth?wsdl

5


Simple ACH Authorization – Common Error Messages

Common Validation Messages (ConfirmationNumber=ERRORED)-

1. MERCHANT ID NOT FOUND IN OUR RECORDS

2. IP ADDRESS 999.999.999.999 NOT AUTHORIZED TO PERFORM THIS ACTION

3. PAYMENT HAS ALREADY BEEN COMPLETED

4. BANK ROUTING NUMBER MUST BE 9 DIGITS

5. INVALID BANK ROUTING NUMBER

6


Authorization with Batch Out – Includes both ACHAuth and BatchOut.

Production: https://www.ttechpayments.net/WebCheckServices/ACHAuth?wsdl

Test: http://174.120.132.226/WebCheckServices/ACHAuth?wsdl

Production: https://www.ttechpayments.net/WebCheckServices3/BatchOut?wsdl

Test: http://174.120.132.226/WebCheckServices3/BatchOut?wsdl

7


Authorization with Batch Out – Common BatchOut Error Messages

Common Validation Messages (ConfirmationNumber=ERRORED)-

1. MERCHANT ID NOT FOUND IN OUR RECORDS

2. IP ADDRESS 999.999.999.999 NOT AUTHORIZED TO PERFORM THIS ACTION

3. BATCH ID ALREADY UPLOADED - DUPLICATE BATCH ID

4. CHECK DATE DOES NOT MATCH AUTHORIZATION

5. CHECK AMOUNT DOES NOT MATCH AUTHORIZATION

6. DUPLICATE ITEM

7. ORPHAN TRAN ID NOT FOUND IN ACH AUTH

8. ALREADY DEPOSITED ON MM/DD/YYYY.

9. INVALID TRANSACTION ID

8

TTech Webcheck Services

Refund -

Production: https://www.ttechpayments.net/WebCheckServicesRefund/Gateway?wsdl

Test: https://www.174.120.132.226/WebCheckServicesRefund/Gateway?wsdl

9

TTech WebCheck Services

Refund - Request

Field Name Type Description

MerchantID Integer TTech Assigned Merchant ID.

RefundTransactionID Varchar(30) Merchant Assigned Unique Tran ID.

RefundTransactionAmount Currency Dollar Amount of Refund. Must Be

Same As Original Payment Amount

Unless PreApproved By TTech For

Lesser Amounts.

RefundDate Date Date of Refund.

PaymentTransactionID Varchar(30) Original Unique Payment Transaction

ID.

PaymentTransactionAmount Currency Dollar Amount of Original Payment

Transaction.

PaymentTransactionDate Date Original Payment Transaction Date.

RefundCheckingRoutingNumber Varchar(9) NOT REQUIRED. By Special

Arrangement with TTech, May Be

Permitted to Use Alternate Checking

Info. Otherwise, Original Consumer

Checking Info is Used.

RefundCheckingAccountNumber Varchar(14) NOT REQUIRED. By Special

Arrangement with TTech, May Be

Permitted to Use Alternate Checking

Info. Otherwise, Original Consumer

Checking Info is Used.

MiscData1 Varchar(255) NOT REQUIRED. For Reporting

Purposes Only.


Purposes Only.


Porposes Only.

PassPhrase Varchar(10) PreArrange PassPhrase.

10


Refund – Response

Field Name Type Description

MerchantID Integer TTech Assigned Merchant ID.

RefundTransactionID Varchar(30) Merchant Assigned Unique Tran

ID.

RefundTransactionAmount Currency Dollar Amount of Refund. Must

Be Same As Original Payment

Amount Unless PreApproved By

TTech For Lesser Amounts.

RefundDate Date Date of Refund.

ConfirmationNumber Varchar(20) Confirmed Refund Unique ID

0 = ERROR

ErrorCode Integer 1 = SUCCESS

See Error Constants Table on

Next Page

ValidationMessage Varchar(255) Further Detail of Any Validation

Messages

Data1 Varchar(255) Passthrough from Request

MiscData1.


MiscData2.


MiscData3.

11


Refunds – Error Code Constants

Error Constant Name Value

_SYSTEM_ERROR 0

_SUCCESS 1

_VALIDATION_ERROR_INVALID_MERCHANT_ID 2

_VALIDATION_ERROR_INVALID_PAYMENT_TRAN_ID 3

_VALIDATION_ERROR_INVALID_PAYMENT_AMOUNT 4

_VALIDATION_ERROR_INVALID_PAYMENT_DATE 5

_VALIDATION_ERROR_INVALID_REFUND_TRAN_ID 6

_VALIDATION_ERROR_INVALID_REFUND_CHECK_AMOUNT 7

_VALIDATION_ERROR_INVALID_REFUND_CHECK_DATE 8

_VALIDATION_ERROR_INVALID_CHECK_NUMBER 9

_VALIDATION_ERROR_INVALID_ROUTING_NUMBER 10

_VALIDATION_ERROR_INVALID_CHECKING_ACCOUNT 11

_VALIDATION_ERROR_IP_ADDRESS_NOT_AUTH 12

_VALIDATION_ERROR_USER_NOT_AUTHORIZED 13

_VALIDATION_ERROR_REFUND_ALREADY_PROCESSED 14

_VALIDATION_ERROR_ORIGINAL_PAYMENT_NOT_FOUND 15

_VALIDATION_ERROR_ORIGINAL_PAYMENT_AMOUNT_NOT_MATCHED 16

_VALIDATION_ERROR_ORIGINAL_PAYMENT_DATE_NOT_MATCHED 17

_VALIDATION_ERROR_INVALID_PASSPHRASE 18

_VALIDATION_ERROR_REFUND_GREATER_THAN_PAYMENT_AMOUNT 19

_VALIDATION_ERROR_REFUND_LESS_THAN_PAYMENT_AMOUNT 20

_VALIDATION_ERROR_NOT_PERMITTED_OVERRIDE_ORIGINAL_CHECKING 21

_VALIDATION_ERROR_MISSING_ACCOUNT_OR_ROUTING 22

_VALIDATION_ERROR_REFUND_SERVICE_NOT_ENABLED 23

12


Reports – Payments Pending to Deposit

Key Features

1. View Detail (See Next Page)

2. Summary List Downloadable to Microsoft Excel.

13


Reports – Payment Detail Report

Key Features

1. Cancel a Payment Prior to Deposit

2. ReSend eMail Confirmation to Consumer

3. Downloadable to Microsoft Excel

14


Reports – Deposit Register Summary

Key Features

1. Query By Date Range

2. Summary List and Detail Register Downloadable to Microsoft Excel.

15


Reports – Search Payments Tool

Key Features

1. Query By Field Value


3. Downloadable to Microsoft Excel.

16


Reports – Batch Out Summary

Key Features

1. Multiple Batches Per Day

2. Batches Cancelable Prior to Deposit

3. Downloadable to Microsoft Excel.


Documents

WebCheck Web Services Interface 2.0 August 2010 · TTech WebCheck Services Refund - Request Field Name Type Description MerchantID Integer TTech Assigned Merchant ID. RefundTransactionID