Back
Appendix B – Functional Reference & Result Fields

In version 3.0 of the system, there are many ways to integrate a merchant's server with the system. This section provides a convenient reference to
all of the types of information than can be sent to the system, and all of the things that could be expected in return. All integration with the system
is done by performing an HTML form POST to https://secure.RTWare.net/gateway/transact.dll

Form Fields

The following table provides an alphabetical list of all of the possible values that will be recognized by the systems when sent in an HTML form.
This table specifies which fields and which values are needed for each of the different connection types.

CLICK HERE FOR TABLE

Result Fields

The table below provides a reference to all of the fields of information that are included in the batch download file, or are returned by one of the
Automated Direct Connect (ADC) methods.

The ADC methods provide a method by which a merchant's server can integrate directly with the system to send transactions and receive
responses.

The ADC Relay Response method will return an HTML form POST containing the following fields to a script written by the merchant to
complete the purchasing process and/or generate an HTML page to be displayed to the customer. The URL of this script is designated
using the x_ADC_URL field, and must be set as one of the Valid ADC or Receipt Link URLs in the URL Manager section of the Settings
menu. This post will occur after the transaction is processed, and the response given by the merchant's script will be displayed to the
customer as the result of the transaction. It is possible that none of the system's pages will ever be displayed using this method.

The ADC Direct Response method will return a simple comma delimited string (field1,field2,field3,etc.) containing the fields from the following
table in the order indicated below. This format can be changed in the Automated Direct Connect (ADC) Settings section of the Settings menu.
A developer would parse this string to obtain the desired information.

Position in Direct Response return	Field Name	Description
1	x_response_code	Indicates the result of the transaction. 1 = Approved, 2 = Declined, 3 = Error
2	x_response_subcode	A code used by the system for internal transaction tracking
3	x_response_reason_code	A code representing more details about the result of the transaction.
4	x_response_reason_text	Brief description of result, which corresponds with the Response Reason Code
5	x_auth_code	6 digit approval code
6	x_avs_code	Indicates the result of Address Verification System (AVS) checks. A = Address (Street) matches, ZIP does not E = AVS error N = No Match on Address (Street) or ZIP P = AVS not applicable for this transaction R = Retry – System unavailable or timed out S = Service not supported by issuer U = Address information is unavailable W = 9 digit ZIP matches, Address (Street) does not X = Exact AVS Match Y = Address (Street) and 5 digit ZIP match Z = 5 digit ZIP matches, Address (Street) does not
7	x_trans_id	This number identifies the transaction in the system, and can be used to submit a modification of this transaction at a later time via HTML form POST (such as voiding the transaction, or capturing an Auth Only transaction).
8	x_invoice_num	echoed from form input values
9	x_description	echoed from form input values
10	x_amount	echoed from form input values
11	x_method	echoed from form input values
12	x_type	echoed from form input values
13	x_cust_id	echoed from form input values
14	x_first_name	echoed from form input values
15	x_last_name	echoed from form input values
16	x_company	echoed from form input values
17	x_address	echoed from form input values
18	x_city	echoed from form input values
19	x_state	echoed from form input values
20	x_zip	echoed from form input values
21	x_country	echoed from form input values
22	x_phone	echoed from form input values
23	x_fax	echoed from form input values
24	x_email	echoed from form input values
25	x_ship_to_first_name	echoed from form input values
26	x_ship_to_last_name	echoed from form input values
27	x_ship_to_company	echoed from form input values
28	x_ship_to_address	echoed from form input values
29	x_ship_to_city	echoed from form input values
30	x_ship_to_state	echoed from form input values
31	x_ship_to_zip	echoed from form input values
32	x_ship_to_country	echoed from form input values
33	x_tax	echoed from form input values
34	x_duty	echoed from form input values
35	x_freight	echoed from form input values
36	x_tax_exempt	echoed from form input values
37	x_po_num	echoed from form input values
38	x_md5_hash	generated by the system and to be validated by merchant for added security
39	any merchant defined fields in the order the system received them	echoed from form input values

Last updated: Monday, January 03, 2000 10:22 AM MDT
Back to Home

Maverick BankCard, Inc. under its trade name of Bankcard USA Merchant Services is a registered Service Provider for Harris Trust & Savings Bank, Chicago, IL. FDIC Insured. American Express and Discover Card require separate approval.
Copyright © 2000-2007 BankCard USA Merchant Services. All Rights Reserved.

Back Appendix B – Functional Reference & Result Fields

Form Fields

Result Fields

Back
Appendix B – Functional Reference & Result Fields