FishNet, Inc.
View CartWednesday: March 10, 2010
Back: E-Commerce Solutions

Online Credit Card Merchant Accounts

Digital Certificates

ACCard Merchant Account Application

Digital Certificate Application

ACCard Online Clearing Parameters

FishCard Gateway Service

ACCard Online Clearing Parameters

When your ACCard online clearing account setup is complete with FishNet, you can begin submitting transactions through. The following parameters are used to submit values for processing. Each parameter is given with an "O" or "R" for its optional and required use.

The access URL is <https://accgate.fishnet.us/apps/acc_xml_gate>. All parameters should be passed via POST method. A valid merchant ID is required to be activated by FishNet before transactions will be processed.

Name Description Sale Auth Post Auth Credit Void
x_merchid Merchant ID
(FishNet Supplied)
R R R R R
x_ttype Transaction Type
string, 1 char
R R R R R
x_cc_number Credit Card Number
string, 21 chars
R R R R R
x_cc_mon Credit Card Expiration Month
string, 2 chars
R R R R R
x_cc_yr Credit Card Expiration Year
string, 2 chars
R R R R R
x_cvv2 CVV2 Value
integer
O O O O O
x_invoice Invoice Number
string, 20 chars
R R R R O
x_custcode Customer Code
string, 20 chars
O O O O O
x_tax_amount Tax Amount
decimal, 8 numbers
O O O O O
x_trans_amount Transaction Amount
decimal, 8 numbers
R R R R R
x_merch_ref Merchant Reference Number
string, 50 chars
R O O O O
x_fname Cardholder First Name
string, 50 chars
O O O O O
x_lname Cardholder Last Name
string, 50 chars
O O O O O
x_avs_addr AVS Address
string, 50 chars
O O O O O
x_avs_city AVS City
string, 50 chars
O O O O O
x_avs_state AVS State
string, 50 chars
O O O O O
x_avs_zip AVS Postal Code
string, 50 chars
O O O O O
x_avs_country AVS Country
string, 50 chars
O O O O O
x_ship_addr Shipping Address
string, 50 chars
O O O O O
x_ship_city Shipping City
string, 50 chars
O O O O O
x_ship_state Shipping State
string, 50 chars
O O O O O
x_ship_zip Shipping Postal Code
string, 50 chars
O O O O O
x_ship_country Shipping Country
string, 50 chars
O O O O O
x_orig_auth Original Authorization Code
string, 6 chars
O O O O O
x_orig_invoice Original Invoice
string, 20 chars
O O O O O
x_orig_uniqid Original Unique ID
string, 255 chars
O O O O R


Transaction Code Transaction Type
S Sale
A Auth
P Post Auth
C Credit
V Void

Transaction Types

The following paragraphs describe the transaction types.

Typically if products are shipped within 24 hours, a Sale transaction can be used. If the ship cycle is longer, an Auth should be used initially, and a Post Auth transaction issued after the product is shipped.

A Sale transaction will authorize the amount of the sale and capture the funds providing the authorization is approved. A Sale transaction is the equivalent of running an Authorization and then running a Post Authorization moments later.

An Authorization transaction will lower a cardholder s right to buy by the amount specified, and reserve that amount for the merchant. The amount will remain reserved for approximately seven days, at which time the card-issuing bank will release it. In order to capture the cardholder's funds, you must run a Post Authorization transaction within the seven-day window to settle the transaction.

A Post Authorization is used to capture funds from a previously obtained authorization, either electronically or by voice. If the authorization was obtained electronically, you must pass the original authorization number, and original invoice number of the authorization transaction. If the authorization was obtained through a voice authorization it is not necessary to pass an invoice number.

A Credit transaction credits money back to a cardholder's account. To reverse a sale that took place on or before the previous day's business, execute or run a credit transaction to give back the cardholder all or part of the funds captured in the original sale.

A Void transaction voids any Sale, Post Authorization, or Credit transaction that was submitted successfully on the same business day that the Void transaction was submitted. If the Sale or Post Authorization was processed during the previous day's business, then you must perform a Credit transaction to credit the cardholder's account. If you are attempting to reverse a credit that took place during a previous day's business, you must run a Sale transaction that will debit the cardholder's account and offset the credit.

Return Values

The clearing process returns a comma (',') separated string of values that give the result of the transaction. The values returned, from left to right in the string, are the following.
Data Content Data Value
Status Code 0 means success, non 0 is the transaction error code
Authorization Response A 6 digit transaction ID if successful; this should be retained, as it is required for Post Auth or Partial Reversal Transactions.
AVS Response
Possible Values:

A: address matched, zip did not
E: error occured
N: neither zip nor address matched
R: system not available or has timed out
S: system not supported by issuer
W: match of 9 digit zip only; address did not match
X: exact match of address and 9 digit zip code
Y: match of address and 5 digit zip code
Z: match of 5 digit zip only; address did not match
U: address information is currently unavailable
G: global non-AVS participant
CVV2 Response Returned value if a CVV2 was provided with the transaction; possible values are below.

M: CVV2 value matches
N: CVV2 value did not match
P: CVV2 value was not processed
S: CVV2 was on the card, but the request indicated that it was missing from the card.
U: CVV2 value was unavailable
Duplicate Response 0 = non duplicate, 1 = duplicate
Unique ID The provided Unique ID is returnd in this field; it should be retained, as it is required to void a previous transaction.
Merchant Reference Number The provided Merchant Reference Number is returned in this field.
Error Text A brief error string if the status code is non zero.
Required Action A text string; may be null.
Device ID The device ID used for the transaction.

Information for returned error codes can be found by accessing the following link, modifying the Data=??? parameter to the numeric error code desired. The example link shows the values for error code 1.

https://terminal.cardtranz.net/web/HelpSystem/Reports/ResponseCode.asp?Data=1


| HOME | SERVICES | PRODUCTS | DIRECTORIES | SUPPORT | REGISTER DOMAINS | CHRISTIAN WEBSITES | CONTACT US |
FishNet®, Inc. P.O. Box 940451 Plano, Texas 75094-0451  972.669.0041  866.529.1843  webmaster@fishnetinc.com