(c) PCI Pal 2020. The content on this page is subject to the Disclaimer Section (found on the Introduction page)
Authorize.Net Payment Gateway
This page details the inputs, secure inputs and outputs available for the Authorize.Net Payment Gateway, how to complete each field, and an external link to the Authorize.Net integration documentation.
PCI Pal must check any payment gateway integrations prior to going live. The documentation disclaimer (which applies throughout this guide) should be read before commencing any configuration of payment gateways.
PCI Pal only supports the usage of the Authorize.Net Direct API, use of accept.js and any other Authorize.Net API is not supported by PCI Pal
Inputs
Input Fields
Required
Character
Limits/
Required
Input
Description
name
Yes
25 char
Merchant’s unique API Login ID.
transactionKey
Yes
16 char
Merchant’s unique Transaction Key.
refId
20 char
Merchant-assigned reference ID for the request. Returned back in the response also.
transactionType
Yes
n/a
Type of credit card transaction. (authCaptureTransaction/authOnlyTransaction/refundTransaction)
amount
Yes
decimal
Amount of the transaction.
poNumber
25 char
The merchant-assigned purchase order number.
customer_id
20 char
The unique customer ID used to represent the customer associated with the transaction.
billTo_firstName
Yes
50 char
First name associated with customer’s billing address.
billTo_lastName
Yes
50 char
Last name associated with customer’s billing address.
billTo_company
Yes
50 char
Company associated with customer’s billing address.
billTo_address
Yes
60 char
Customer’s billing address.
billTo_city
Yes
40 char
City of customer’s billing address.
billTo_state
Yes
40 char
State of customer’s billing address.
billTo_zip
Yes
20 char
The postal code of customer’s billing address.
billTo_country
Yes
60 char
Country of customer’s billing address.
shiplTo_firstName
50 char
First name associated with customer’s shipping address.
shipTo_lastName
50 char
Last name associated with customer’s shipping address.
shipTo_company
50 char
Company associated with customer’s shipping address.
shipTo_address
60 char
Customer’s shipping address.
shipTo_city
40 char
City of customer’s shipping address.
shipTo_state
40 char
State of customer’s shipping address.
shipTo_zip
20 char
Postal code of customer’s shipping address.
shipTo_country
60 char
Country of customer’s shipping address.
refTransId
Yes (for refund)
n/a
Transaction ID of the original request. (refunds only)
Secure Inputs
Input Fields
Required
Character Limits/
Required Input
Description
cardNumber
Yes
19 num
Secure input of the card number
expirationDate
Yes
2 num
Secure input of the card expiry - in the format MM
cardCode
Yes
3 or 4 num
Secure input of the card CVV, either three or four digits long depending on the card
Outputs
Output Fields
Description
response_refId
Merchant-assigned reference ID for the request.
resultCode
States whether the request was handled successfully, or ended with an error. (Ok/Error
code2
The code number for the result.
text
Text explanation of the code for the result.
transId
The Authorize.Net assigned identification number for a transaction.
authCode
The authorization code granted by the card issuing bank for this transaction.
transHash
Payment gateway-generated MD5 hash value that can be used to authenticate the transaction response.
response_refTransID
The transaction ID of a related, previously settled transaction.
accountType
The card account type used for the transaction (Visa, Mastercard, Discover, AmericanExpress, DinersClub, JCB or eCheck)
testRequest
Denotes if this was a test transaction
responseCode
The overall status of the transaction. (1 = Approved, 2 = Declined, 3 = Error, 4 = Review)
accountNumber
The masked card number or bank account number used for the transaction.
avsResultCode
Address Verification Service (AVS) response code.
cvvResultCode
Card code verification (CCV) response code.
transHashSha2
The SHA-512 hash returned in transaction responses, which you can use to confirm that the transaction response came from Authorize.Net.
The first character is either an I for informational responses, or E for error responses. The remaining characters are numeric and indicate the type of informational or error response.
description
Text explanation of the code for the result.
errorCode
Error code returned.
errorText
Text description of error.
SupplementalDataQualificationIndicator
-
Further information can be found by viewing the integration documentation:
