*** Authorize.net AIM Emulation
Please note that the below fields were incorporated using the AIM_guide.pdf.
This pdf can be retrieved at https://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 0724
mm-yyyy ie 07-2024
yyyy-mm ie 2024-11
mm/yyyy ie 07/2024
yyyy/mm ie 2024/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: |
| 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 | 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 |
| 40 |
Cardholder Authentication Verification Value (CAVV) Response Code |
Indicates the results of cardholder authentication verification:
Blank or not present = CAVV not validated |