Skip to content. | Skip to navigation

Sections
Credit Card Processing Simplified
Payment Processing Simplified
Personal tools
Home → Support Center → CreditNow! → TransFirst ePayment Services → TransFirst ePayment Services Field Reference

TransFirst ePayment Services Field Reference

CreditNow! AutoProcessor V3.1.6

 

Version 1.0
23 July 2004

 

 

Field Name Type Length Importable Field Pattern Description
Account AN 20 Y
Credit Card, Purchase Card, or Checking Account number.
Credit Card and Purchase Card numbers may contain dashes ('-') or spaces. Checking account numbers should not have spaces.
Action Lookup N Y
Defines type of transaction. Must be one of the following:
Action Description
A, C6 Authorize
S, C, C1 Conditional Deposit
D Deposit
R, C3 Refund

C1, C3, and C6 are provided for IC-Verify compatibility.

Check Information Under Development.
Activity Date D&T N N M/D/YYYY H:M:S AMPM
M/D/YY H:M:S AMPM		 Date and time at which the activity specified in the Action field took place, i.e., when was it authorized, when was it refunded, when was it deposited, etc. Date and time is keyed to the server on which CN-3000 is running and not the time at the processor's location.
Amount N N Y #########.## Amount of this transaction. The decimal point and the two digits to the right of the decimal place are required. For MasterCard and Visa transactions, the amount must be greater than or equal to $0.01USD. For American Express, Discover Card, and Diners/Carte Blanche transactions, the amount must be greater than or equal to $1.00 USD.
Auth Code AN 6 Y
Authorization Approval code returned by processor. Field should be blank for Auth, Refund, and Conditional Deposit transactions. Deposit transactions should enter information returned by the initial Auth transaction.
Authorization Source Code AN 1 Y
Authorization Source Code.
Authorized Amount N N Y
Amount of this transaction for which an Authorization has already been obtained. Used for MasterCard.
Authorized Date D&T N Y M/D/YYYY H:M:S AMPM
M/D/YY H:M:S AMPM		 Date and time at which Authorization was received. For Authorization transactions, filled in by Processor on Authorization transactions. Needs to be imported for Deposit transactions.
AVS AN 6 Y
Address Verification Response code returned by processor, if AVS is used.
Otherwise blank.
AV Requested N N Y
"Y" if AVS service was requested and "N" if it was not.
AVS Message AN 80 N
Textual description of the AVS response code. String starts with the AVS response code, followed by a space, two dashes, another space and the message.
Batch ID AN 10 Y
An arbitrary batch identifier which may be imported for tracking purposes. If not imported, CN-3000 generates a Batch ID. This Batch ID is not transmitted to processor and is not used for tracking transactions with processor.
BillAddress:Address1 AN 30 Y
First address line of customer billing address. Used for AVS.
BillAddress:Address2 AN 30 Y
Second address line of customer billing address. Used for AVS.
BillAddress:Apt AN 6 Y
Apartment portion of customer billing address. Should say 50, not Apt 50. Used for AVS.
BillAddress:City AN 20 Y
City portion of customer billing address. Used for AVS.
BillAddress:Country Lookup N Y
Country portion of customer billing address.
Note: AVS currently only available for USA.
Code Country
CA Canada
US United States
BillAddress:Email AN 50 Y
Email portion of customer billing address.
Example: customer@example.com. Used for AVS.
BillAddress:FirstName AN 40 Y
Customer's first name on card or checking account. Used for AVS.
BillAddress:HomePhone AN 20 Y AAAEEENNNXXXX Home phone portion of customer billing address. Used for AVS.
AAA Area Code
EEE Exchange
NNNN Number
XXXX Extension
BillAddress:LastName AN 40 Y
Customer's last name on card or checking account. Used for AVS.
BillAddress:MiddleInitial AN 5 Y
Customer's middle initial, not a middle name. Six characters for people who use two initials: G. A. Not intended for use by van as in van Beethovan. Used for AVS.
BillAddress:State/Prov AN 20 Y
US State or Canadian Province Code portion of customer billing address. Used for AVS.
BillAddress:WorkPhone AN 20 Y AAAEEENNNNXXXX Work phone number of customer billing address. Used for AVS.
AAA Area Code
EEE Exchange
NNNN Number
XXXX Extension
BillAddress:Zip/Postal Code AN 10 Y 03458
03458-0458
N1D 1E5		 A five-digit US Zip Code, 10-character Zip+4, or seven-character Canadian Postal Code.
This field may only contain properly formatted US Zip or Canadian Postal codes.
Captured Date D&T N Y M/D/YYYY H:M:S AMPM
M/D/YY H:M:S AMPM		 Date and time at which the capture occured. Filled in for C and D transactions.
Card Type Lookup N Y
Type of credit or purchase card. If imported, value is only used if type cannot be determined from the account number. If not imported, the two-character code is automatically generated by CN-3000.
Card Type is case insensitive.
Card Description
AM, AMEX American Express
CB, CarteBlanche Carte Blanche
DC, Diners Diners Club
DS, Discover Discover card
JC, JCB JCB
MC, Mastercard Mastercard International
VI, Visa Visa International
IN Invalid
UN Unknown
Class Lookup N Y
Class. Must be one of the following:
Class Description
M Mail Order/Phone Order: MOTO
R Recurring
E E-Commerce
D Merchant Default
I Installment
CNX Order ID N N Y
Order identifier used internally by CN-3000. Typically neither imported nor exported. This is not the processor's Order ID (see Order Number field)
Comment 1 AN 64 Y
Free-form descriptive field. Information is not transmitted to processor.
Comment 2 AN 64 Y
Free-form descriptive field. Information is not transmitted to processor.
Comment 3 AN 64 Y
Free-form descriptive field. Information is not transmitted to processor.
Comment 4 AN 64 Y
Free-form descriptive field. Information is not transmitted to processor.
Commercial Card Type Lookup N Y
Describes the specific type of Commercial Card (Purchase Card) used for this transaction. Must be one of the following:
B Business Card
C Corporate Card
N None
P Purchase Card
U Unknown
V VISA Commerce

Enter a blank (default) if it is not a commercial card.
Created Date D&T N N M/D/YYYY H:M:S AMPM
M/D/YY H:M:S AMPM		 Date and Time at which the transaction was created in CN-3000 database. Useful for debugging purposes or tracking flow of transactions.
Cust Ref AN 15 Y
TransPay calls this the Customer Number.
CVV Message AN 80 N
Text description of CID/CVV2 result.
CVV Resp AN 1 Y
CVV2/CID response code returned by processor if CVV2 or CID submitted.
CVV/CID AN 4 Y
A three-digit value for MasterCard CVC2, Visa CVV2, and Discover CID. Number is usually printed on the back of the customers card. Used for fraud deterrence. TransFirst currently does not support CID for American Express or CVV for Discover.
Discount N N Y #########.## Discount Amount.
Duty N N Y #########.## Amount of duty included in the transaction.
Exp AN 7 Y MM/YY Credit card expiration date.
Freight N N Y #########.## Amount of freight included in the transaction.
ICV-Style Response AN 255 N
See appendix on IC-Verify compatibility features.
Invoice AN 10 Y
Invoice number for this order. Not sent to processor.
LastActionSucceeded N N N
Flag indicating whether the last requested transaction action succeeded. Field is 1 if successful and 0 if not. Use this field to check for success or failure when writing programs that read CN-3000 exported files.
MC Banknet Date AN 4 Y MMDD Authorization date assigned by the MasterCard authorization system. Used with externally-obtained MasterCard authorizations.
NOTE: format is MMDD for Month and Day. Year is not passed.
MC Banknet Reference Number AN 9 Y
Reference number assigned by the MasterCard authorization system. Used with externally-obtained MasterCard authorizations.
Merchant Action AN 10 N
Suggested merchant action for declined or rejected transaction. These are suggested, probable courses of action for commonly received response codes.
Action Description
Call Call TransFirst
Cust. Try to resolve with customer or get an alternative method of payment.
Fix There is an invalid field being sent. Fix and resend.
Resend Resubmit this transaction at any time.
Voice Perform a voice authorization.
Wait Wait 2-3 days before sending back, or try to resolve with customer.
Merchant Number AN 8 Y
Merchant Number provided by TransFirst.
Merchant Name AN 20 N
Merchant name associated with this Merchant number. Not imported. Merchant name and number are associated in the AutoProcessor configuration dialog.
Order Date D N Y M/D/YYYY
M/D/YY		 Date that customer placed the order.
Order Number AN 8 Y
Used to track transactions. Do not use pipe(|), caret (^), percent symbol (%) or backslash () in the Order Number.
Payment Interval AN 1 Y
If this transaction is an installment or recurring transaction (if the Transaction Class field is set to “I” or “R”, how often is the customer billed?
Interval Description
M Monthly
W Weekly
B 60 Days (every two months)
Q Quarterly
S Semi-annually (2x per year)
A Annually
Payment Number N N Y
If this transaction is part of an installment or recurring payment (if the Transaction Class field is set to “I” or “R”, what number payment is this? Valid values are 01-99.
PO Number AN 25 Y
Customer Purchase Order Number.
Processor Status AN 2 Y
Status value returned from payment processor.
Reauth Attempt Number N 1 Y
If this transaction is an attempt to re-authorize a transaction that has already been declined, set this value to the number of the reauth attempt, i.e., 1 for the first attempt to reauth, 2, for the second, etc. Defaults to 0 indicating initial authorization attempt. If you do not do re-auth attempts, you do not need to import this field.
Response Code AN 6 Y
TransFirst returns a three-digit response code. 000 means success. See Appendix A of TransPay QuickBatch specification for response code details.
Response Date D&T N Y M/D/YYYY H:M:S AMPM
M/D/YY H:M:S AMPM		 Date and Time the Authorization Response was obtained.
Response Text AN 255 Y
Text description of the transaction result. Importable, but ignored. Usually export only.
Returned ACI AN 1 Y
TransPay name is the Auth Char Response Indicator. Code that indicates if the transaction CPS qualified. Do not import for Authorization. When posting, this field is required for CPS qualification. You must use the value returned by TransFirst in the authorization request to fill this field.
Code Description
V Transaction CPS qualified.
N/space Transaction did not qualify for CPS.
W CPS qualified for basic E-Commerce CPS.
Ship Date D N Y M/D/YYYY
M/D/YY		 Date on which the product shipped.
Ship From Zip/PC AN 20 Y
Zip code or Canadian postal code from which product was shipped.
ShipAddress:Address1 AN 30 Y
First address line of customer shipping address.
ShipAddress:Address2 AN 30 Y
Second address line of customer shipping address.
ShipAddress:Apt AN 6 Y
Apartment portion of customer shipping address. Should say 50 and not Apt 50.
ShipAddress:City AN 20 Y
City portion of customer shipping address.
ShipAddress:Country Lookup N Y
Country portion of customer shipping address.
Code Country
CA Canada
US United States
ShipAddress:Email AN 50 Y
Email portion of customer shipping address.
Example: customer@example.com.
ShipAddress:FirstName AN 40 Y
Customer's first name on shipping address.
ShipAddress:HomePhone AN 20 Y AAAEEENNNNXXXX HomePhone part of ship-to address for this order.
ShipAddress:LastName AN 40 Y
LastName part of ship-to address for this order.
ShipAddress:MiddleInitial AN 5 Y
Customer's middle initial, not a middle name. Six characters for people who use two initials: G. A. Not intended for use by van as in van Beethovan.
ShipAddress:State/Prov AN 20 Y
US State or Canadian Province Code portion of customer shipping address.
ShipAddress:WorkPhone AN 20 Y AAAEEENNNNXXXX Work phone number of customer shipping address.
AAA Area Code
EEE Exchange
NNNN Number
XXXX Extension
ShipAddress:Zip/Postal Code AN 10 Y 03458
03458-0458
N1D 1E5		 A five-digit US Zip Code, 10-character Zip+4, or seven-character Canadian Postal Code.
This field may only contain properly formatted US Zip or Canadian Postal codes.
Shipping Ref AN 40 Y
Shipping Reference Number. Comment only.
Status AN 20 N
Transaction Status:
  • Authorized
  • Closed
  • Captured
  • Entered
  • Failed
  • Refunded
  • Voided
Soft Descriptor 1 AN 10 Y
TransFirst Payment Description field.
This field contains the text you want placed on the customer's monthly statement for this transaction. If it is blank (or not imported) TransFirst determines this value based on the information contained in their merchant database for that merchant number.
Soft Descriptor 2 AN 10 Y
TransFirst Customer Service Number.
This text fields contains the phone number that a customer can call regarding questions or concerns about their order. It will appear on the customer's monthly statement for this transaction. If it is blank (or not imported) TransFirst determines the value based on the information contained in the TransFirst merchant database for that merchant number.
Tax N N Y #########.## Amount of sales tax included in the transaction.
Tax Exempt Yes/No N Y
'Y' if customer is tax exempt. Otherwise 'N'.
Tender Type Lookup N Y
Tender Type. CN-3000 is able to automatically distinguish between credit card and check (ECP) transactions based on the information imported for the transaction. If a Bank Routing number is imported, CN-3000 assumes the Tender Type is Check. CN-3000 cannot distinguish between a credit card and a purchase card. If you are processing purchase cards, you must import the Tender Type. If this field is blank, CN-3000 will distinguish between checks and credit careds. Must be one of the following:
Type Description
C Credit Card
P Purchase Card
C Check
Total Installment Payments N N Y
If this transaction is part of an installment payment (if the Transaction Class field is set to “I”, what is the total number of installments to be made?
Number Description
01 Single Payment (default)
02-98 Multiple payments
Transaction Identifier AN 15 Y
Visa Transaction ID.
Transaction Reference Key AN 100 Y
A processor-neutral transaction reference. When doing two-pass Authorize/Deposit transactions, this remembering and returning this field is a convenient way to remember all the processor-specific information needed to Deposit the transaction.
This field is required when performing PreAuth and Capture (Auth/Deposit) transactions with TransFirst ePayment Services.
The Transaction Reference Key contains the following fields:
  • Transaction Identifier
  • Auth Code
  • Authorization Source Code
  • Authorized Date
  • AVS
  • Cust Ref
  • ECP Reference Number
  • MC Banknet Date
  • MC Banknet Reference Number
  • Processor Status
  • Response Code
  • Returned ACI
  • Validation Code
User AN 20 N
Name of user that imported the transaction. Currently only one user. In future, different import channels will have different users.
User Description
_cnap_ Transaction imported from a file.
Validation Code AN 4 Y
A code calculated by the card issuer that is used to determine the accuracy of the authorization data. Required for posting (capture/deposit) transactions. Auth (pre-auth) request should be empty. Tracked in Transaction Reference Key.
Document Actions