CN!Express CX-6000 AP
|
CN!Express CX-7000
|
|
|
Field Name
|
Field
Name
|
Group
|
Type/Sample
|
|
Account |
Common
Request Fields |
A/N[22] |
| Account |
ACCT |
4111-1111-1111-1111 |
| |
Credit
Card, Purchase Card, Debit Card, or Checking Account number. |
| |
Credit
Card, Purchase Card, and Debit Card numbers may contain dashes ('-') or
spaces. Checking account numbers should not have spaces. |
| |
For
transactions using Track 1 or Track 2 data, the account field is extracted
from the track data and returned to the caller. The account field is masked
on export (last four digits) by default. If PROCTID or CNXTID are not
retained (which is recommended practice), merchants using separate
authorization and capture transactions must retain the auhorization account
number for later capture. |
| |
Supported
for all processors |
| |
|
| |
Action |
Common
Request Fields |
A|C6|C4|S|C|C1|R|C3|D|CO|V|F|OO|PA|PR|VR|RA|FD|Q|GD A/N(2)
|
| Action |
ACTION |
A |
| |
The
action to take, or the type of the transaction, such as authorize, capture,
or refund. |
| |
|
| |
These
action codes are specific to CN!Express— they are not the same as the action
codes or transaction types understood by the various gateways. CN!Express
translates these codes as appropriate for each back-end gateway. |
| |
|
| |
Code |
Action |
Description |
| |
A,C4,C6 |
Authorize |
Obtain
an authorization for this transaction. Used when you intend to capture funds
at a later time, such as when the product ships. |
| |
D,CO |
Deposit/Capture |
Mark
a transaction for capture. You must have previously obtained an authorization
for this transaction. |
| |
F |
Force/Voice |
Capture
a transaction for which you don't have electronic authorization (you may have
voice authorization). |
| |
FD |
FinalDeposit |
PayPal
specific. Capture funds for the order and mark the order as complete. |
| |
GD |
GetDetails |
PayPal
specific. Return the details for a transaction. |
| |
OO |
OpenOrder |
PayPal
specific. Open a new order. An order can contain several related
transactions. |
| |
PA |
PartialAuth |
If
full funds are not available, authorize for a lesser amount. |
| |
PR |
PartialRefund |
Refund
part of a transaction. |
| |
Q |
Query |
PayPal
specific. Return information for transactions that match specified criteria. |
| |
R,C3 |
Refund |
Return
funds to the account holder. |
| |
RA |
RefundAuthorization |
Obtain
an authorization for a refund transaction (debit cards only). |
| |
S,C,C1 |
Sale |
Authorize
and then immediately mark the transaction for capture. |
| |
V |
Void |
Undoes
a mark-for-capture, but only if the capture has not been completed (typically
all transactions that are marked for capture are captured at the end of the
business day). |
| |
VR |
VoidRefund |
Void
a pending refund transaction. |
| |
|
| |
Not
all actions are supported by all payment processors. C,CO,C1,C3,C4 and C6 are
aliases that are provided for compatibility with legacy systems generating
IC-Verify formats. |
| |
Supported
for all processors |
| |
|
| |
Activity
Date |
Other |
M/D/YYYY
[H:M:S] |
| Activity Date |
ACTVDATE |
39142.59897 |
| |
Date
and time at which the transaction was processed. For an authorization, this
is the time the authorization was obtained. For a capture, this is the time
the item was marked for capture.. |
| |
CN!Express
— not the payment processor — generates this value. |
| |
The
server on which CN!Express is running determines the date and time value. |
| |
Supported
for all processors |
| |
|
| |
Address
Verified |
PayPal |
1|0 |
| |
ADDRVRFD |
1 |
| |
A
boolean field returned by PayPal if the payer's address has been verified. |
| |
Supported
for PayPal only |
| |
|
| |
Alternate
Tax Amount |
PC
Level 3/Detail Records |
N[12] |
| Alt Tax
Amount |
ALTTXAMT |
1 |
| |
Used
only for MasterCard Purchase Card Level 3 transactions. |
| |
Total
amount of alternate tax associated with this transaction. |
| |
If
this field is populated (including zero filled) Alternate Tax ID is required. |
| |
Local
field/ reserved for future use |
| |
|
| |
Alternate
Tax ID |
PC
Level 3/Detail Records |
A/N[15] |
| Alt Tax ID |
ALTTXID |
01-234-5678 |
| |
Used
only for MasterCard Purchase Card Level 3 transactions. |
| |
Tax
ID number for the alternate tax associated with this transaction. |
| |
Required
if there is an amount in Alternate Tax Amount. |
| |
Local
field/ reserved for future use |
| |
|
| |
Amount |
Common
Request Fields |
N[12] |
| Amount |
AMT |
34 |
| |
Amount
of this transaction. |
| |
The
decimal point and the two digits to the right of the decimal place are
required except when processing Yen. When processing Yen, the decimal place
and digits to the right are not allowed. |
| |
Amounts
must not contain commas or currency symbol. |
| |
$1,000.00
is incorrect. 1000.00 is correct. |
| |
Minimum
amount for all card types is $0.01 USD (or established international currency
equivalent). |
| |
|
| |
This
amount is in the currently selected currency for the division. |
| |
Supported
for all processors |
| |
|
| |
ASI
Response |
Common
Response Fields |
A/N[3] |
| |
ASIRESP |
100 |
| |
The
numeric response code generated by CN!Express (the response codes are common
to all software built by Auric Systems International). |
| |
These
codes are normalized across all divisions and payment processors. Use this
value to make programatic decisions on the disposition of a transaction. |
| |
Code |
Description |
|
| |
100 |
Approved |
|
| |
101 |
Local
duplicate detected |
|
| |
102 |
Accepted
local capture with no match |
|
| |
103 |
Auth
succeeded but capture failed |
|
| |
104 |
Auth
succeeded but failed to save info |
|
| |
200 |
Declined |
|
| |
300 |
Processor
reject |
|
| |
301 |
Local
reject on user/password |
|
| |
302 |
Local
reject |
|
| |
303 |
Processor
unknown response |
|
| |
304 |
Error
parsing processor response |
|
| |
305 |
Processor
auth succeeded but settle failed |
|
| |
306 |
Processor
auth succeeded settle status unknown |
|
| |
307 |
Processor
settle status unknown |
|
| |
308 |
Processor
duplicate |
|
| |
400 |
Not
submitted |
|
| |
401 |
Terminated
before request submitted |
|
| |
402 |
Local
server busy |
|
| |
500 |
Submitted
not returned |
|
| |
501 |
Terminated
before response returned |
|
| |
502 |
Processor
returned timeout status |
|
| |
600 |
Failed
local capture with no match |
|
| |
601 |
Failed
local capture |
|
| |
700 |
Failed
local void (not in capture file) |
|
| |
701 |
Failed
local void |
|
| |
800 |
Failed
local refund (not authorized) |
|
| |
801 |
Failed
local refund |
|
| |
Supported
for all processors |
| |
|
| |
Auction
Buyer ID |
PayPal |
A/N[50] |
| |
AUCTBYR |
1234565 |
| |
Returned
by PayPal in response to a GetDetails transaction. The customer's auction ID. |
| |
Supported
for PayPal only |
| |
|
| |
Auction
Closing Date |
PayPal |
M/D/YYYY |
| |
AUCTDATE |
39142 |
| |
Returned
by PayPal in response to a GetDetails transaction. The auctions's close date. |
| |
Supported
for PayPal only |
| |
|
| |
Auction
Item Number |
PayPal |
A/N[32] |
| |
AUCTITM |
99 |
| |
Can
be specified in a PayPal Query transaction. Search by the auction item
number. |
| |
Supported
for PayPal only |
| |
|
| |
Auction
Multi-Item Counter |
PayPal |
N[8] |
| |
AUCTMULT |
22 |
| |
Returned
by PayPal in response to a GetDetails transaction. The counter value in a
multi-item auction payment. |
| |
Supported
for PayPal only |
| |
|
| |
Total
Authorized Amount |
Separate
Auth/Capture |
N[12] |
| Authorized
Amount |
AUTHAMT |
1 |
| |
The
current amount authorized for deposit. |
| |
For
ChasePaymentech Orbital Gateway, used only for Void transactions. If
specified, CN!Express will perform a partial void, voiding only this amount. |
| |
For
Transfirst ePay, an optional field that specifies the amount of the current
authorization. |
| |
Supported
for: Chase Paymentech Orbital Gateway,Transfirst ePay |
| |
|
| |
Authorization
Code |
Common
Response Fields |
A/N[6] |
| Auth Code |
AUTHCODE |
123456 |
| |
The
authorization code returned by the payment processor. This is returned for
Authorize and Sale transactions. If you do not track and return the CNXTID or
PROCTID (which is the recommended practice), you must return the
authorization code with a Deposit transaction. Authorization codes are most
important for credit card transactions. Electronic check and debit card
transactions may return blank or dummy values. |
| |
Supported
for: Chase Paymentech Orbital Gateway,Trident Payment Gateway,Transfirst ePay |
| |
|
| |
Authorized
Date (may include time) |
Common
Response Fields |
M/D/YYYY
[H:M:S] |
| Authorized
Date |
AUTHDATE |
39142 |
| |
The
date on which an authorization was obtained. This is returned by the payment
processor after an Authorization transaction. |
| |
Supported
for: Chase Paymentech Orbital Gateway,PayPal,Transfirst ePay |
| |
|
| |
Auth
MOP |
Debit
Cards |
A/N[2] |
| |
AUTHMOP |
PP |
| |
The
authorizing method of payment. Retuned by the payment processor after a debit
card authorization. This field tells the specific type of debit card that was
used. If not using CNXTID or PROCTID, you must return the AUTHMOP when
settling debit card transactions. |
| |
Local
field/ reserved for future use |
| |
|
| |
Authorization
Source Code |
Credit
Card Authorization Specifics |
A/N[1] |
| |
AUTHSRC |
E |
| |
Returned
by Transfirst ePay. Indicates the source of the authorization. |
| |
Supported
for Transfirst ePay only |
| |
|
| |
AVS
Requested |
AVS |
1|0 |
| AV Requested |
AVREQ |
1 |
| |
Currently
unused. A boolean value that specifies whether or not Address Verification
Service was requested. CN!Express automatically requests AVS whenever
sufficient information is available. |
| |
Local
field/ reserved for future use |
| |
|
| |
AVS
Response |
AVS |
A/N[6] |
| AVS |
AVSRESP |
I3 |
| |
Address
Verification Service response code returned by processor, if AVS is used.
Otherwise blank. |
| |
See
payment processor documentation for specific response codes. |
| |
Supported
for all processors |
| |
|
| |
AVS
Message |
AVS |
A/N[80] |
| AVS Message |
AVSTEXT |
I3
-- Match Except +4 |
| |
Textual
description of the AVS response code. |
| |
Supported
for all processors |
| |
|
| |
Batch
ID |
Other |
A/N[10] |
| Batch ID |
BATCHID |
BATCHID |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
BillAddress:Address
1 |
AVS |
A/N[100] |
| BillAddress:Address1 |
BILLADD1 |
22
Sample Lane |
| |
First
address line of customer billing address. |
| |
Supported
for: Chase Paymentech Orbital Gateway,Trident Payment Gateway,Transfirst ePay |
| |
|
| |
BillAddress:Address
2 |
AVS |
A/N[100] |
| BillAddress:Address2 |
BILLADD2 |
PO
Box 22 |
| |
Second
address line of customer billing address. |
| |
Supported
for Chase Paymentech Orbital Gateway only |
| |
|
| |
BillAddress:Apt |
Other
Addresses |
A/N[6] |
| BillAddress:Apt |
BILLAPT |
22 |
| |
Apartment
portion of customer billing address. This field is not sent to the payment
processor. |
| |
Local
field/ reserved for future use |
| |
|
| |
BillAddress:City |
AVS |
A/N[40] |
| BillAddress:City |
BILLCITY |
Peterborough |
| |
City
portion of customer billing address. |
| |
Supported
for: Chase Paymentech Orbital Gateway,Transfirst ePay |
| |
|
| |
BillAddress:Company |
Other
Addresses |
A/N[50] |
| |
BILLCO |
Example
Corp. |
| |
The
payer's company name. |
| |
Supported
for PayPal only |
| |
|
| |
BillAddress:Country |
AVS |
A/N[3] |
| BillAddress:Country |
BILLCTRY |
US |
| |
Country
portion of customer billing address. AVS is available only for these
countries. You must specify the country using one of the following values. If
this field is not specified, CN!Express assumes a US address. |
| |
Code |
Country |
|
| |
CA |
Canada |
|
| |
GB |
UK |
|
| |
UK |
UK |
|
| |
US |
USA |
|
| |
USA |
USA |
|
| |
Supported
for Chase Paymentech Orbital Gateway only |
| |
|
| |
BillAddress:Email |
Other
Addresses |
A/N[50] |
| BillAddress:Email |
BILLEMAL |
jasmith@example.com |
| |
Email
portion of customer billing address. |
| |
Example:
customer@example.com. |
| |
Supported
for: PayPal,Transfirst ePay |
| |
|
| |
BillAddress:First
Name |
Customer
Name |
A/N[40] |
| BillAddress:FirstName |
BILLFNAM |
John |
| |
Customer's
first name on card or checking account. Specify either the name components
(e.g., BILLFNAM, BILLMI, BILLLNAM) or the full name (BILLNAME), depending on
how these fields are used in your implementation. |
| |
Supported
for PayPal only |
| |
|
| |
BillAddress:Home
Phone |
Other
Addresses |
A/N[20] |
| BillAddress:HomePhone |
BILLHPHO |
6035551212 |
| |
Home
phone portion of customer billing address. |
| |
Supported
for: Chase Paymentech Orbital Gateway,Transfirst ePay |
| |
|
|
BillAddress:Last
Name |
Customer
Name |
A/N[40] |
| BillAddress:LastName |
BILLLNAM |
Smith |
| |
Customer's
last name on card or checking account. Specify either the name components
(e.g., BILLFNAM, BILLMI, BILLLNAM) or the full name (BILLNAME), depending on
how these fields are used in your implementation. |
| |
Supported
for PayPal only |
| |
|
| |
BillAddress:Middle
Initial |
Customer
Name |
A/N[5] |
| BillAddress:MiddleInitial |
BILLMI |
A |
| |
Customer's
middle initial (not a middle name). Do not use for compound last names (e.g.,
van Beethoven); put the entire last name in the BILLLNAM field |
| |
Supported
for PayPal only |
| |
|
| |
Customer
Full Name |
Customer
Name |
A/N[30] |
| |
BILLNAME |
John
Smith |
| |
Customer's
full name as it appears on card or checking account. Specify either the name
components (e.g., BILLFNAM, BILLMI, BILLLNAM) or the full name (BILLNAME),
depending on how these fields are used in your implementation. |
| |
Supported
for: Chase Paymentech Orbital Gateway,PayPal,Transfirst ePay |
| |
|
| |
Biller
Reference |
Other |
A/N[20] |
| Cust Ref |
BILLRREF |
BILLER
REF |
| |
An
optional reference number that can be used by the merchant to identify the
customer. |
| |
Supported
for Transfirst ePay only |
| |
|
| |
BillAddress:Salutation |
Customer
Name |
A/N[20] |
| |
BILLSALU |
Ms. |
| |
The
billing name salutation (e.g., "Mr.") |
| |
Supported
for PayPal only |
| |
|
| |
BillAddress:State/Province |
AVS |
A/N[40] |
| BillAddress:State/Prov |
BILLSTPR |
NH |
| |
US
State or Canadian Province Code portion of customer billing address. |
| |
Supported
for: Chase Paymentech Orbital Gateway,Transfirst ePay |
| |
|
| |
BillAddress:Suffix |
Customer
Name |
A/N[12] |
| |
BILLSUFX |
Jr. |
| |
The
billing name suffix (e.g., "Jr.") |
| |
Supported
for PayPal only |
| |
|
| |
BillAddress:Work
Phone |
Other
Addresses |
A/N[20] |
| BillAddress:WorkPhone |
BILLWPHO |
6032222222 |
| |
Work
phone number of customer billing address. |
| |
Local
field/ reserved for future use |
| |
|
| |
BillAddress:ZIP/Postal
Code |
AVS |
A/N[20] |
| BillAddress:Zip/Postal
Code |
BILLZCPC |
3458 |
| |
A
five-digit US Zip Code, ten-character Zip+4, seven-character Canadian Postal
Code or UK Postal Code. (UK AVS is supported by Chase Paymentech Orbital
Gateway only). |
| |
Valid
field formats are: |
| |
Format |
Country |
|
| |
NNNNN |
US |
|
| |
NNNNN-NNNN |
US |
|
| |
ANAANA |
CAN |
|
| |
ANA
ANA |
CAN |
|
| |
AN
NAA |
UK |
|
| |
ANA
NAA |
UK |
|
| |
ANN
NAA |
UK |
|
| |
AAN
NAA |
UK |
|
| |
AANN
NAA |
UK |
|
| |
AANA
NAA |
UK |
|
| |
Supported
for: Chase Paymentech Orbital Gateway,Trident Payment Gateway,Transfirst ePay |
| |
|
| |
BML
Item Category |
Bill
Me Later |
A/N[4] |
| |
BMLCAT |
4000 |
| |
Bill
Me Later product description code assigned by I4 Commerce. Cannot be all
blanks. Required for Bill Me Later batch transactions. |
| |
Local
field/ reserved for future use |
| |
|
| |
BML
Customer Type |
Bill
Me Later |
A/N[2] |
| |
BMLCUST |
E |
| |
Describes
whether this is a new or existing Bill Me Later customer. |
| |
Code |
Description |
|
| |
E |
Existing |
|
| |
N |
New |
|
| |
Local
field/ reserved for future use |
| |
|
| |
Capture
Amount |
PayPal |
N[12] |
| |
CAPAMT |
4 |
| |
The
capture amount, returned by PayPal. This includes any currency conversion. |
| |
Supported
for PayPal only |
| |
|
| |
Captured
Date |
Separate
Auth/Capture |
M/D/YYYY
[H:M:S] |
| Captured Date |
CAPDATE |
39142.59897 |
| |
Date
and time at which the capture occurred. Returned by CN!Express for C and D
transactions. In most cases this value is returned by the processor, but if
it is not provided, CN!Express will return the local date at capture. |
| |
Supported
for: Chase Paymentech Orbital Gateway,PayPal,Transfirst ePay |
| |
|
| |
Card
Level Results |
Additional
Credit Card |
A/N[2] |
| |
CARDLEVL |
0 |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
Card
Present |
Retail |
A/N[1] |
| |
CARDPRES |
0 |
| |
Indicates
if the card was present when the transaction was originated. |
| |
Value |
Description |
|
| |
0 |
Card
not present |
|
| |
1 |
Card
present |
|
| |
W |
AMEX
Transponder |
|
| |
Local
field/ reserved for future use |
| |
|
| |
Card
Type |
Credit
Cards |
A/N[2] |
| Card Type |
CARDTYPE |
MC |
| |
Type
of credit or purchase card, for credit card transactions. If imported, value
is only used if type cannot be determined from the account number. |
| |
If
not imported, CN!Express automatically generates a two-character code. |
| |
Field
is blank if transaction is not a credit card transaction (or credit card
account number is not valid). |
| |
Card
Type is case insensitive on import. |
| |
Card |
Description |
|
| |
AM |
American
Express/Optima |
|
| |
CB |
Carte
Blanche |
|
| |
DC |
Diners
Club |
|
| |
DS |
Discover |
|
| |
JC |
JCB |
|
| |
MC |
MasterCard
International |
|
| |
SW |
Switch/Solo |
|
| |
VI |
Visa |
|
| |
Supported
for: Chase Paymentech Orbital Gateway,Transfirst ePay |
| |
|
| |
Carrier
Tracking Number |
Shipment
Address/Info |
A/N[40] |
| Shipping Ref |
CARTRACK |
1Z9999W99999999999 |
| |
The
shipper's tracking number for the order as delivered to the customer. |
| |
Supported
for Chase Paymentech Orbital Gateway only |
| |
|
| |
Cashback
Amount |
Debit
Cards |
N[12] |
| |
CASHBACK |
1 |
| |
Amount
(of the total amount) customer has requested for cashback. |
| |
Used
with PIN-based debit card transactions. |
| |
Local
field/ reserved for future use |
| |
|
| |
CAT
Type |
Additional
Credit Card |
A/N[1] |
| |
CATTYPE |
1 |
| |
Type
of Card Activated Terminal. |
| |
Used
for Retail transactions. |
| |
Valid
values: |
| |
Code |
Description |
|
| |
1 |
Automated
Dispensing Machine |
|
| |
2 |
Self
Service Terminal |
|
| |
3 |
Limited
Amount Terminal |
|
| |
Local
field/ reserved for future use |
| |
|
| |
Card
Capture Capability |
Additional
Credit Card |
A/N[1] |
| |
CCAPCAPB |
1 |
| |
Describes
the capture capability of the terminal. |
| |
American
Express only. This is additional information that you can specify to describe
the transaction environment. |
| |
Value |
Description |
|
| |
0 |
Unknown |
|
| |
1 |
Capture |
|
| |
Local
field/ reserved for future use |
| |
|
| |
Card
Data Output Capability |
Additional
Credit Card |
A/N[1] |
| |
CDOPCAPB |
0 |
| |
Describes
the card-update capability of the terminal. |
| |
American
Express only. This is additional information that you can specify to describe
the transaction environment. |
| |
Value |
Description |
|
| |
0 |
Unknown |
|
| |
1 |
None |
|
| |
Local
field/ reserved for future use |
| |
|
| |
Cardholder
Authentication Capability |
Additional
Credit Card |
A/N[1] |
| |
CHATCAPB |
0 |
| |
Local
field/ reserved for future use Describes the authentication capability of the
terminal. |
| |
American
Express only. This is additional information that you can specify to describe
the transaction environment. |
| |
Value |
Description |
|
| |
0 |
Unknown
or none |
|
| |
6 |
Other |
|
| |
Local
field/ reserved for future use |
| |
|
| |
Cardholder
Authentication Entity |
Additional
Credit Card |
A/N[1] |
| |
CHATENT |
0 |
| |
Local
field/ reserved for future use Indicates the entity that authenticated the
card holder. |
| |
Including
this information may improve the interchange rate for this transaction.
Contact payment processor for specific requirements. |
| |
Value |
Description |
|
| |
0 |
Not
authenticated |
|
| |
1 |
Chip
card |
|
| |
2 |
Card
acceptor device |
|
| |
4 |
Merchant |
|
| |
5 |
Other |
|
| |
Local
field/ reserved for future use |
| |
|
| |
Check
Number |
POP/Arc |
A/N[9] |
| |
CHECKNUM |
123 |
| |
Optional
check number for electronic checks. |
| |
Required
only for ARC and POP transactions. |
| |
Local
field/ reserved for future use |
| |
|
| |
Checking
Account Type |
Checks |
C|S|X |
| Check Acct
Type |
CHKTYPE |
C |
| |
The
bank account type for check transactions. |
| |
Type |
Description |
|
| |
C |
Consumer
Checking |
|
| |
S |
Consumer
Savings |
|
| |
X |
Commercial
Checking |
|
| |
See
Debit Account type field for debit transactions. |
| |
Local
field/ reserved for future use |
| |
|
| |
Cardholder
Present |
Additional
Credit Card |
A/N[1] |
| |
CHPRES |
2 |
| |
Indicates
whether the customer is present or not, and, if not present, indicates the
type of transaction. |
| |
American
Express only. This is additional information that you can specify to describe
the transaction environment. |
| |
Value |
Description |
|
| |
0 |
Present |
|
| |
1 |
Not
present, unknown |
|
| |
2 |
Not
present, mail order |
|
| |
3 |
Not
present, telephone |
|
| |
4 |
Not
present, standing auth |
|
| |
9 |
Not
present recurring |
|
| |
S |
Not
present, electronic |
|
| |
Local
field/ reserved for future use |
| |
|
| |
Comment
1 |
Comments |
A/N[128] |
| Comment 1 |
CMT1 |
Comment
1 |
| |
Free-form
descriptive field. Although you can always use this field for your own
comments, information is transmitted to the payment processor only if
processor is in supported list. |
| |
Supported
for: Chase Paymentech Orbital Gateway,PayPal,Transfirst ePay |
| |
|
| |
Comment
2 |
Comments |
A/N[128] |
| Comment 2 |
CMT2 |
Comment
2 |
| |
Free-form
descriptive field. Although you can always use this field for your own
comments, information is transmitted to the payment processor only if
processor is in supported list. |
| |
Supported
for: PayPal,Transfirst ePay |
| |
|
| |
Comment
3 |
Comments |
A/N[128] |
| Comment 3 |
CMT3 |
Comment
3 |
| |
Free-form
descriptive field. Although you can always use this field for your own
comments, information is transmitted to the payment processor only if
processor is in supported list. |
| |
Supported
for PayPal only |
| |
|
| |
Comment
4 |
Comments |
A/N[128] |
| Comment 4 |
CMT4 |
Comment
4 |
| |
Free-form
descriptive field. Information is not transmitted to payment processor. |
| |
Local
field/ reserved for future use |
| |
|
| |
CNX
Order ID |
Identifiers |
A/N[40] |
| CNX Order ID |
CNXORDR |
ORD-cnx0-2398 |
| |
The
order identifier as generated by CN!Express. An order is a grouping of
transactions related to an individual customer order. Not currently used, but
completes the set of identifiers that may be used to identify a transaction.
CNXTID is the CNX transaction ID. PROCTID is the processor's transaction ID.
CNXORDR is the CNX order ID. PROCORDR is the processor's order ID. |
| |
Local
field/ reserved for future use |
| |
|
| |
CNX
Transaction ID |
Identifiers |
A/N[40] |
| Transaction
Reference Key |
CNXTID |
TID-cnx0-P23090 |
| |
The
identifier used by CN!Express to refer to a single transaction. This is
returned for all transactions. You can return this field or CNXTID to
CN!Express when processing a later transaction (for example, return the
CNXTID associated with an authorization when capturing the transaction). |
| |
Supported
for PayPal only |
| |
|
| |
Commercial
Card Type |
PC
Level 2 |
B|C|N|P|U |
| Commercial
Card Type |
COMCRDTY |
B |
| |
Describes
the type of Commercial Card (Purchase Card) used for this transaction. |
| |
Local
field/ reserved for future use |
| |
|
| |
Created
Date |
Other |
M/D/YYYY
[H:M:S] |
| Created Date |
CRTDDATE |
39142.59897 |
| |
Date
and Time at which the transaction was created in CN!Express database. Useful
for tracking transaction flow or debugging purposes. |
| |
Local
field/ reserved for future use |
| |
|
| |
Currency |
Other |
A/N[3] |
| Currency |
CUR |
USD |
| |
The
three-letter code that specifies the currency for the transaction. |
| |
Processors
associate currency types with merchant numbers/divisions. Typically, you will
set up currency as a default value per division in CN!Express and not import
currencies with each transaction. |
| |
Some
typical currencies are listed below. Not all processors support all currency
types. |
| |
Code |
Currency |
|
| |
AUD,
036 |
Australian
Dollar |
|
| |
GBP,
826 |
British
Pounds Sterling |
|
| |
CAD,
124 |
Canadian
Dollar |
|
| |
DKK,
208 |
Danish
Krone (Krona) |
|
| |
EUR,
978 |
Euro |
|
| |
HKD,
344 |
Hong
Kong Dollar |
|
| |
JPY,
392 |
Japanese
Yen |
|
| |
NZD,
554 |
New
Zealand Dollar |
|
| |
NOK,
578 |
Norwegian
Krone (Krona) |
|
| |
SGD,
702 |
Singapore
Dollar |
|
| |
ZAR,
710 |
South
African Rand |
|
| |
SEK,
752 |
Swedish
Krona |
|
| |
CHF,
756 |
Swiss
Franc |
|
| |
USD,
840 |
US
Dollar |
|
| |
Supported
for: Chase Paymentech Orbital Gateway,PayPal |
| |
|
| |
Customer
Changed Billing Address |
Customer
Infomation |
1|0 |
| |
CUSTADCH |
0 |
| |
Optional
for Bill Me Later. |
| |
Indicates
if customer has updated their billing address at merchant site. |
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
ANI |
Additional
Credit Card |
A/N[10] |
| |
CUSTANI |
6039246079 |
| |
Customer
Automatic Number Identification. |
| |
The
phone number the customer used to place a phone order, as specified by
Automatic Number Identification. |
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
Drivers License Country |
Customer
Infomation |
A/N[2] |
| |
CUSTDLCT |
US |
| |
Used
for Bill Me Later. |
| |
Customer's
driver's license country. (Optional) |
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
Drivers License Number |
Customer
Infomation |
A/N[40] |
| |
CUSTDLNO |
ABC-432392981 |
| |
Used
for Bill Me Later. |
| |
Customer's
driver's license number. (Optional) |
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
Drivers License State/Prov |
Customer
Infomation |
A/N[2] |
| |
CUSTDLSP |
NH |
| |
Used
for Bill Me Later. |
| |
Customer's
driver's license state. (Optional) |
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
Date Of Birth |
Customer
Infomation |
M/D/YYYY |
| |
CUSTDOB |
25680 |
| |
Required
for Bill Me Later authorization transactions. |
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
Changed Email Address |
Customer
Infomation |
1|0 |
| |
CUSTEMCH |
1 |
| |
Optional
for Bill Me Later. |
| |
Indicates
if customer has updated their email address at merchant site. |
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
Years At Employer |
Customer
Infomation |
N[2] |
| |
CUSTEMYR |
4 |
| |
Used
for Bill Me Later. |
| |
Optional
for authorization transactions. |
| |
Number
of years with current employer. Round up to nearest year. |
| |
Example:
5 months = 1 year. |
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
Gross Household Income |
Customer
Infomation |
N[12] |
| |
CUSTGHI |
45500 |
| |
Used
for Bill Me Later. |
| |
Gross
annual household income. (Optional) |
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
Gross Household Income Currency |
Customer
Infomation |
A/N[3] |
| |
CUSTGHIC |
USD |
| |
Used
for Bill Me Later. |
| |
Currency
type of gross household annual income. (Optional). See CUR field for list of
typical currencies. |
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
Has Checking Account |
Customer
Infomation |
1|0 |
| |
CUSTHASC |
1 |
| |
Used
for Bill Me Later. |
| |
Optional
for authorization transactions. |
| |
Y |
Yes,
customer has a checking account. |
|
| |
N |
No,
customer does not have a checking account. |
|
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
Has Savings Account |
Customer
Infomation |
1|0 |
| |
CUSTHASS |
1 |
| |
Used
for Bill Me Later. |
| |
Optional
for authorization transactions. |
| |
Y |
Yes,
customer has a savings account. |
|
| |
N |
No,
customer does not have a savings account. |
|
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
Host |
ECommerce
Customer Info |
A/N[60] |
| |
CUSTHOST |
myserver.example.com |
| |
Name
of the customer host used in an e-commerce transaction. |
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
ii |
Additional
Credit Card |
A/N[2] |
| |
CUSTII |
0 |
| |
Customer
information identifier. |
| |
The
Automatic Number Identification ii digits reported for the call when the
customer placed the order, which identify the call type (e.g., cellular). |
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
IP Address |
ECommerce
Customer Info |
###.###.###.### |
| |
CUSTIP |
192.168.24.1 |
| |
Internet
address of customer during an Ecommerce transaction. |
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
Changed Home Phone Number |
Customer
Infomation |
1|0 |
| |
CUSTPHCH |
0 |
| |
Optional
for Bill Me Later. |
| |
Indicates
if customer has updated their home phone number at merchant site. |
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
Changed Password |
Customer
Infomation |
1|0 |
| |
CUSTPWCH |
0 |
| |
Optional
for Bill Me Later. |
| |
Indicates
if customer has changed their password at merchant site. |
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
Residence Status |
Customer
Infomation |
O|R|X |
| |
CUSTRESD |
O |
| |
Used
for Bill Me Later. |
| |
Optional
for authorization transactions. |
| |
Status
of customer residence: |
| |
Code |
Description |
|
| |
O |
Own |
|
| |
R |
Rent |
|
| |
X |
Other |
|
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
Years At Residence |
Customer
Infomation |
N[2] |
| |
CUSTRSYR |
2 |
| |
Used
for Bill Me Later. |
| |
Optional
for authorization transactions. |
| |
Number
of years at current residence. Round up to nearest year. |
| |
Example:
5 months = 1 |
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
Social Security Number |
Customer
Infomation |
A/N[11] |
| |
CUSTSSN |
111-22-3333 |
| |
Used
for Bill Me Later. |
| |
Optional
for authorization transactions. |
| |
Local
field/ reserved for future use |
| |
|
| |
Customer
User Agent |
ECommerce
Customer Info |
A/N[60] |
| |
CUSTUA |
MOZILLA/4.0
(COMPATIBLE; MSIE 5.0; WINDOWS 95) |
| |
Name
of the customer user agent used in an e-commerce transaction. |
| |
Local
field/ reserved for future use |
| |
|
| |
CVV/CID |
Credit
Cards |
A/N[4] |
| CVV/CID |
CVV |
123 |
| |
Supported
for: Chase Paymentech Orbital Gateway,Trident Payment Gateway,Transfirst ePay
The three or four-digit card security code. Used for fraud deterrence for
credit card transactions. According to card industry rules, the CVV must not
be retained after an authorization is obtained. CN!Express clears this value
immediately after authorization and will never return a non-blank CVV. |
| |
American
Express |
4-digits |
Card
Identification Number (CID) |
| |
Discover |
3-digits |
Card
Identification Number (CID) |
| |
MasterCard |
3-digits |
Card
Verification Code (CVC2) |
| |
Visa |
3-digits |
Card
Verification Value (CVV2) |
| |
Supported
for: Chase Paymentech Orbital Gateway,Trident Payment Gateway,Transfirst ePay |
| |
|
| |
CVV
Presence |
Additional
Credit Card |
P|NP|I |
| CVV Presence |
CVVPRES |
P |
| |
Indicates
the presence of a Card Security value. Supported by Visa, MasterCard, and
Discover. |
| |
Must
be one of the following: |
| |
Code |
Description |
|
| |
|
Blank:
Indicator not sent. |
|
| |
P |
Present |
|
| |
NP |
Not
Present |
|
| |
I |
Illegible |
|
| |
If
this field is not imported or blank, it is set to P or NP based on presence
of CVV value. |
| |
This
field should be blank for American Express transactions. |
| |
Supported
for Chase Paymentech Orbital Gateway only |
| |
|
| |
CVV
Response |
Credit
Cards |
A/N[1] |
| CVV Resp |
CVVRESP |
M |
| |
Code
returned by the card issuer in response to a card security verification
request. |
| |
Valid
values: |
| |
Code |
Description |
|
| |
M |
Value
matched (Visa, MasterCard, Discover, FlexCache) |
|
| |
N |
Value
not matched (Visa, MasterCard, Discover, FlexCache) |
|
| |
P |
Not
processed (Visa, MasterCard, Discover, FlexCache) |
|
| |
S |
Should
be on the card (Visa, Discover, FlexCache) |
|
| |
U |
Unsupported
by the Issuer (Visa, MasterCard, Discover, FlexCache) |
|
| |
I |
Invalid
(Visa, MasterCard, Discover, American Express, FlexCache) |
|
| |
|
Blank
(American Express, Bill Me Later) |
|
| |
Both
American Express and Bill Me Later transactions return a blank. |
| |
Supported
for all processors |
| |
|
| |
CVV
Message |
Credit
Cards |
A/N[80] |
| CVV Message |
CVVTEXT |
Match |
| |
Text
description of CID/CVV2 result. |
| |
Supported
for all processors |
| |
|
| |
Debit
Account Type |
Debit
Cards |
C|S |
| |
DEBTACCT |
C |
| |
The
Account Type for debit transactions. |
| |
Must
be one of the following: |
| |
Type |
Description |
|
| |
C |
Consumer
Checking |
|
| |
S |
Consumer
Savings |
|
| |
Local
field/ reserved for future use |
| |
|
| |
Debit
Trace Number |
Debit
Cards |
A/N[8] |
| |
DEBTTRCE |
12345678 |
| |
Trace
number returned from debit card vendor on authorization transactions. |
| |
Local
field/ reserved for future use |
| |
|
| |
All
Details |
PC
Level 3/Detail Records |
A/N[1000] |
| |
DETAILS |
(see
description) |
| |
Transaction
details can be included for purchase card level 3 or for PayPal transactions
(not all processors support these transactions). |
| |
The
details can be specified one of three ways: (1) as part of the import file,
with detail records on lines that follow the transaction line; (2) as serial
fields, marked with tags such as I_AMT_0, I_AMT_1..I_AMT_n; or (3) with all
details in a single field. If detail handling is required, you can configure
CN!Express to accept one of these methods when setting up input formats. |
| |
The
DETAILS field is used with method 3. It contains all detail records in a
single field. The details field is delimited by row and then by field. |
| |
The
DETAIL sub-field layout is fixed. It always contains the following sub-fields
for each row, in the following order. |
| |
Sub-field |
Description |
|
| |
I_DSC |
Item
Description |
|
| |
I_NBR |
Item
Number |
|
| |
I_QTY |
Item
Quantity |
|
| |
I_MSR |
Item
Measure |
|
| |
I_UAM |
Item
Unit Cost |
|
| |
I_DAM |
Item
Discount Amount |
|
| |
I_TXR |
Item
Tax Rate |
|
| |
I_TAX |
Item
Tax |
|
| |
I_AMT |
Item
Amount |
|
| |
I_CMD |
Item
Commodity Code |
|
| |
I_XIN |
Item
Total Includes Tax |
|
| |
I_XTY |
Item
Tax Type |
|
| |
I_DCD |
Item
Discounted |
|
| |
I_CMT |
Item
Comment |
|
| |
I_CRD |
Item
Amount is Credit |
|
| |
I_OPT |
Item
Options |
|
| |
Supported
for all processors |
| |
|
| |
Division
ID |
Common
Request Fields |
A/N[20] |
| Division ID |
DIVISION |
asi-2 |
| |
The
CN!Express division number for this transaction. CN!Express uses divisions to
associate payment processors and payment processor accounts with each
transaction. If you have only one division set up in CN!Express, you don't
need to import this field. |
| |
Local
field/ reserved for future use |
| |
|
| |
Duty |
PC
Level 3/Detail Records |
N[12] |
| Duty |
DUTY |
1 |
| |
Amount
of duty included in the transaction. |
| |
Local
field/ reserved for future use |
| |
|
| |
ECommerce
Type |
Common
Request Fields |
U|E|S|1|2|5|6|7 |
| |
ECOMTYP |
E |
| |
Must
be one of the following: |
| |
Value |
Description |
|
| |
5 |
VbV
Authenticated Transaction |
|
| |
6 |
VbV
Attempted Authentication |
|
| |
E |
HTTPS |
|
| |
S |
Secure
SET |
|
| |
U |
Non-Secure |
|
| |
Only
required if XCLASS field is set to 'E' indicating Ecommerce. |
| |
Typical
Ecommerce setting is E indicating a secure Internet transaction (typically
HTTPS over the Web). This setting is sometimes described as Non-SET Channel
Encrypted. |
| |
SET
is a specific security implementation that is rarely used. |
| |
Supported
for: Chase Paymentech Orbital Gateway,Trident Payment Gateway,Transfirst ePay |
| |
|
| |
ECP
Authorization Method |
Checks |
W|I|T|P|A |
| |
ECPAUTHM |
I |
| |
Method
by which merchant is authorized by customer to conduct this Electronic Check
transaction. Must be one of the following: |
| |
Method |
Description |
|
| |
|
Blank
is Unknown |
|
| |
W |
Written |
|
| |
I |
Internet |
|
| |
T |
Telephone |
|
| |
P |
Point
of Purchase (POP) |
|
| |
A |
Accounts
Receivable Conversion (ARC) |
|
| |
The
ECP Authorization Method may be defaulted at the Chase Paymentech division
level. If the default is set, all transactions processed through the division
will carry the default ECP authorization value unless this field is populated
to override the default. |
| |
Supported
for Chase Paymentech Orbital Gateway only |
| |
|
| |
ECP
Preferred Delivery Method |
Checks |
A|B|F |
| |
ECPDELVM |
A |
| |
The
Preferred Delivery Method for depositing checks. Must be one of the
following: |
| |
Method |
Description |
|
| |
A |
ACH
Automated Clearing House electronic delivery |
|
| |
B |
Best
Possible |
|
| |
Electronic
check refunds require a preferred delivery method of ACH (A). If best
possible (B) is sent, and the RDFI is a non-ACH participant, the transaction
is rejected with Response Code 760 ACH Non-participant. |
| |
Supported
for Chase Paymentech Orbital Gateway only |
| |
|
| |
EDD
Bank Sort Code |
EDD |
A/N[10] |
| EDD Bank Sort
Code |
EDBSC |
1234567890 |
| |
Used
for European Direct Debit Transactions. |
| |
The
identifier of the customer's bank. Each country has its own bank sort code
format. |
| |
Local
field/ reserved for future use |
| |
|
| |
EDD
Country Code |
EDD |
A/N[2] |
| EDD Country
Code |
EDCNTRY |
DE |
| |
Used
for European Direct Debit Transactions. |
| |
This
is a code which indicates the country of the customer's bank. Must be one of
the following: |
| |
Code |
Country |
|
| |
AT |
Austria |
|
| |
BE |
Belgium |
|
| |
DE |
Germany |
|
| |
FR |
France |
|
| |
GB |
United
Kingdom |
|
| |
NL |
Netherlands |
|
| |
Local
field/ reserved for future use |
| |
|
|
EDD RIB Code |
EDD |
A/N[2] |
| EDD RIB Code |
EDRIB |
12 |
| |
Used
for European Direct Debit Transactions. |
| |
The
bank account checksum. This is optional, used only in France. |
| |
Local
field/ reserved for future use |
| |
|
| |
Encryption
Flag |
Other |
A/N[3] |
| |
ENCFLAG |
F |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
End
Date |
PayPal |
M/D/YYYY
[H:M:S] |
| |
ENDDATE |
39172.59897 |
| |
For
Query transactions, the last date to include in the search. |
| |
Supported
for PayPal only |
| |
|
| |
Exchange
Rate |
PayPal |
N[12] |
| |
EXCHRATE |
1.85 |
| |
The
exchange rate for the transaction. Returned by PayPal. |
| |
Supported
for PayPal only |
| |
|
| |
Expiration
Date |
Credit
Cards |
A/N[7] |
| Exp |
EXP |
907 |
| |
Credit
card expiration date: MMYY or MM/YY. Credit card expiration date. Send blanks
(or 0000) if the card has expired since the order was placed or if the true
expiration date is unknown |
| |
Omitting
the expiration date on a card-not-present transaction, while acceptable to
some card processors and debit networks, may result in a decline code from
the Issuer. |
| |
Examples: |
| |
[blank] |
|
|
| |
0 |
|
|
| |
00/00 |
|
|
| |
MMYY |
|
|
| |
MM/YY |
|
|
| |
Supported
for: Chase Paymentech Orbital Gateway,Trident Payment Gateway,Transfirst ePay |
| |
|
| |
Existing
Debt |
Additional
Credit Card |
1|0 |
| |
EXSTDEBT |
0 |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
Freight |
PC
Level 3/Detail Records |
N[12] |
|