QuantumGateway: The Evolution of Payment Processing


*** Authorize.net AIM Emulation

Please note that the below fields were incorporated using the AIM_guide.pdf.
This pdf can be retrieved at http://www.authorize.net/support/AIM_guide.pdf

*** Our Authorize.Net emulation mode is a Basic Emulation of Authorize.Net.
This means that the basic query and response fields are supported - other optional response formats and fields may not be.
If you are using or attempting an integration into an application not currently listed under our known certified shopping carts, it may be necessary for you to make adjustments to your code to match up with the QPG API.

Post URL: https://secure.quantumgateway.com/cgi/authnet_aim.php

Credit Cards
x_version - NOT USED
x_delim_data - Optional
x_relay_response - NOT USED
x_login - Your Gateway Login Name **Required
x_tran_key - RestrictKey obtained from the Processing Config Interface **Required
x_amount - Amount of purchase including tax **Required
x_card_num - Customer's card number **Required
x_exp_date - Customer's card expiration date**Required
                       Acceptable Formats
                                              mmyy ie 0712
                                              mm-yyyy ie 07-2012
                                              yyyy-mm ie 2012-11
                                              mm/yyyy ie 07/2012
                                              yyyy/mm ie 2010/12
x_method - CC **Required
x_type - Type of transaction (AUTH_CAPTURE, AUTH_ONLY, CREDIT ) **Required
                                    AUTH_CAPTURE - Uses AVS and CVV2 settings when charging a credit card
                                    AUTH_ONLY - Auth only, regardless of AVS and CVV2 when charging a credit card
                                    CREDIT - Submit a refund. Full credit card information is required or x_transID and last 4 of CC.
                                    SALES - Ignores AVS and CVV2 settings when charging (this is the same as the CREDIT option)
                                    RETURN - Submit a refund. Full credit card information is required
                                    VOID - Void a previous transaction
                                    PRIOR_AUTH_CAPTURE - Force a previous AUTH_ONLY to settle.
x_card_code - Optional

EFT/Checks
Not Available for authnet emulation

 

Gateway Response Configuration
x_delim_data - Not needed as the response is always TRUE
x_delim_char - Character that will be used to separate fields in the transaction response. If none is sent a | will be used. Characters that can be used are | ~ and ,
x_encap_char - character to wrap around response. IE "1","blah"
x_relay_response - Not used (As all transactions are direct response)
x_duplicate_window - Not used. To use this type of feature please adjust the Pre Processing option on the Processing Config page.

 

Customer Information
x_first_name - Optional
x_last_name - Optional
x_company - Optional
x_address - Optional for Sales only. Required for Auth Only or Auth Convert
x_city - Optional
x_state - Optional
x_zip - Optional for Sales only. Required for Auth Only or Auth Convert
x_country - Optional
x_phone - Optional
x_fax - Optional
x_cust_id - Optional
x_customer_ip - Optional
x_customer_tax_id - Optional
x_email - Any valid email address
x_email_customer - Email Customer Transaction Receipt. TRUE, FALSE (if no value is passed TRUE is used)
x_invoice_num- Optional
x_description - Optional
x_line_item - Optional
x_ship_to_first_name - Optional
x_ship_to_last_name - Optional
x_ship_to_company - Optional
x_ship_to_address - Optional
x_ship_to_city - Optional
x_ship_to_state - Optional
x_ship_to_zip - Optional
x_ship_to_country - Optional

 

Other Options
x_trans_id - Only used with VOID or PRIOR_AUTH_CAPTURE
x_auth_code - NOT USED
x_authentication_indicator- NOT USED
x_cardholder_ authentication_value- NOT USED
x_po_num- NOT USED
x_tax - Sales Tax amount that was included in x_amount - NOT USED
x_tax_exempt - NOT USED
x_freight- NOT USED
x_duty - NOT USED

These items will be removed from all fields.

&, ', ", \, <, >, ), (, [, ], {, }, ;, --, =, #

Gateway Responses

This section describes the response returned by the gateway when a merchant server submits a transaction for processing. The response is a set of fields that give merchants information about the status of a transaction. The fields will be comma delimited by default or delimited by the character specified by the merchant. The merchant server can parse this data and determine the message to display to the customer.

Fields in the Gateway Response

POSITION IN RESPONSE FIELD NAME OF VALUE IN RESPONSE DESCRIPTION
1 Response Code

Indicates the result of the transaction: 1 = Approved 2 = Declined 3 = Error

2 Response Subcode A code used by the system for internal transaction tracking.
Quantum Does Not Use - 1,2 or 3 is displayed
3 Response Reason Code A code representing more details about the result of the transaction.
Quantum Does Not Use - 1,2 or 3 is displayed
4 Response Reason Text Brief description of the result, which corresponds with the Response Reason Code.
Decline Reason if transaction was declined
5 Approval Code The six-digit alphanumeric authorization or approval code.
6 AVS Result Code

Indicates the result of Address Verification System (AVS) checks:
A = Address (Street) matches, ZIP does not
B = Address information not provided for AVS check
E = AVS error
G = Non-U.S. Card Issuing Bank
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 = Address (Street) and 9 digit ZIP match
Y = Address (Street) and 5 digit ZIP match
Z = 5 digit ZIP matches, Address (Street) does not

7 Transaction ID This number identifies the transaction in the system and can be used to submit a modification of this transaction at a later time, such as voiding, crediting or capturing the transaction.
8 Invoice Number Echoed from input value for x_invoice_num.
9 Description Echoed from input value for x_description.
10 Amount Echoed from input value for x_amount.
11 Method Echoed from input value for x_method.
12 Transaction Type Echoed from input value for x_type.
13 Customer ID Echoed from input value for x_cust_id.
14 Cardholder First Name Echoed from input value for x_first_name.
15 Cardholder Last Name Echoed from input value for x_last_name.
16 Company Echoed from input value for x_company.
17 Billing Address Echoed from input value for x_address.
18 City Echoed from input value for x_city.
19 State Echoed from input value for x_state.
20 Zip Echoed from input value for x_zip.
21 Country Echoed from input value for x_country.
22 Phone Echoed from input value for x_phone.
23 Fax Echoed from input value for x_fax.
24 Email Echoed from input value for x_email.
25 Ship to First Name Echoed from input value for x_ship_to_first_name.
26 Ship to Last Name Echoed from input value for x_ship_to_last_name.
27 Ship to Company Echoed from input value for x_ship_to_company.
28 Ship to Address Echoed from input value for x_ship_to_address.
29 Ship to City Echoed from input value for x_ship_to_city.
30 Ship to State Echoed from input value for x_ship_to_state.
31 Ship to Zip Echoed from input value for x_ship_to_zip.
32 Ship to Country Echoed from input value for x_ship_to_country.
33 Tax Amount Echoed from input value for x_tax.
34 Duty Amount Echoed from input value for x_duty.
35 Freight Amount Echoed from input value for x_freight.
36 Tax Exempt Flag Echoed from input value for x_tax_exempt.
37 PO Number Echoed from input value for x_po_num.
38 MD5 Hash System-generated hash that may be validated by the merchant to authenticate a transaction response received from the gateway.
This hash is comprised of MD5-Hash(from Processing Settings), Gateway Login, TransactionID and amount.
Example before md5 encryption of contents
abc123gwtester19568799.50
39

Card Code (CVV2/CVC2/CID) Response Code

Indicates the results of Card Code verification:

M = Match
N = No Match
P = Not Processed
S = Should have been present
U = Issuer unable to process request

40

Cardholder Authentication Verification Value (CAVV) Response Code

Indicates the results of cardholder authentication verification:

Blank or not present = CAVV not validated
0 = CAVV not validated because erroneous data was submitted
1 = CAVV failed validation
2 = CAVV passed validation
3 = CAVV validation could not be performed; issuer attempt incomplete
4 = CAVV validation could not be performed; issuer system error
5 = Reserved for future use
6 = Reserved for future use
7 = CAVV attempt failed validation issuer available (U.S.-issued card/non-U.S acquirer)
8 = CAVV attempt passed validation issuer available (U.S.-issued card/non-U.S. acquirer)
9 = CAVV attempt failed validation issuer unavailable (U.S.-issued card/non-U.S. acquirer)
A = CAVV attempt passed validation issuer unavailable (U.S.-issued card/non-U.S. acquirer)
B = CAVV passed validation, information only, no liability shift



Example Response


1,1,1,,123456,A,11104,1,Online Sales,19.95,CC,AUTH_CAPTURE,101,John,Doe,ABC Inc,1200 12th St,Chesapeake,VA,23320,USA,888-555-1212,888-555-1212,you@yourdomain.com,John,Doe,ABC Inc,1200 12th St,Chesapeake,VA,23320,USA,0.00,0.00,0,N,,,M,2