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] |
| Freight |
FREIGHT |
1 |
| |
Amount
of freight included in the transaction. |
| |
Frequently
called Shipping or Shipping Cost. |
| |
Supported
for PayPal only |
| |
|
| |
Handling
Charge |
PayPal |
N[12] |
| |
HANDLING |
1 |
| |
Amount
of handling fee included in the transaction. |
| |
Supported
for PayPal only |
| |
|
| |
ICV-Style
Response |
Other |
A/N[255] |
| |
ICVRESP |
Y123456Y123456789 |
| |
See
appendix on IC-Verify compatibility features. |
| |
Local
field/ reserved for future use |
| |
|
| |
IGOTS
Transaction Code |
Additional
Credit Card |
A/N[2] |
| |
IGOTS |
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 |
| |
|
| |
Image
Reference Number |
POP/Arc |
A/N[32] |
| |
IMGNUM |
2.90291E+13 |
| |
Image
Reference Number associated with check for POP and ARC transactions.
Optional. |
| |
Local
field/ reserved for future use |
| |
|
| |
Invoice |
Other |
A/N[127] |
| Invoice |
INV |
INV#1234 |
| |
Invoice
number for this order. |
| |
Supported
for PayPal only |
| |
|
| |
Item
Amount |
PC
Level 3/Detail Records |
N[12] |
| |
I_AMT_n |
45.36 |
| |
Transaction
details can be included for purchase card level 3 or for PayPal transactions
(not all processors support these transactions). |
| |
This
field is used to specify detail information using a serial tag format. See
the DETAILS field for other formats. I_AMT_0 represents the amount for the
first item, I_AMT_1 represents the amount for the second item, etc. |
| |
Supported
for all processors |
| |
|
| |
Item
Commodity Code |
PC
Level 3/Detail Records |
N[12] |
| |
I_CMD_n |
CAP |
| |
Transaction
details can be included for purchase card level 3 or for PayPal transactions
(not all processors support these transactions). |
| |
This
field is used to specify detail information using a serial tag format. See
the DETAILS field for other formats. I_CMD_0 represents the commodity code
for the first item, I_CMD_1 represents the commodity code for the second
item, etc. |
| |
Local
field/ reserved for future use |
| |
|
| |
Item
Comment |
PC
Level 3/Detail Records |
A/N[127] |
| |
I_CMT_n |
Line
item comment |
| |
Transaction
details can be included for purchase card level 3 or for PayPal transactions
(not all processors support these transactions). |
| |
This
field is used to specify detail information using a serial tag format. See
the DETAILS field for other formats. I_CMT_0 is a comment for the first item,
I_CMT_1 is a comment for the second item, etc. |
| |
Local
field/ reserved for future use |
| |
|
| |
Item
Amount Is Credit |
PC
Level 3/Detail Records |
1|0 |
| |
I_CRD_n |
0 |
| |
Transaction
details can be included for purchase card level 3 or for PayPal transactions
(not all processors support these transactions). |
| |
This
field is used to specify detail information using a serial tag format. See
the DETAILS field for other formats. I_CRD_0 is true if the first item is a
credit, I_CRD_1 is true if the second item is a credit, etc. |
| |
Local
field/ reserved for future use |
| |
|
| |
Item
Discount Amount |
PC
Level 3/Detail Records |
N[9] |
| |
I_DAM_n |
4.8 |
| |
Transaction
details can be included for purchase card level 3 or for PayPal transactions
(not all processors support these transactions). |
| |
This
field is used to specify detail information using a serial tag format. See
the DETAILS field for other formats. I_DAM_0 represents the discount amount
for the first item, I_DAM_1 represents the discount amount for the second
item, etc. |
| |
Local
field/ reserved for future use |
| |
|
| |
Item
Discounted |
PC
Level 3/Detail Records |
1|0 |
| |
I_DCD_n |
1 |
| |
Transaction
details can be included for purchase card level 3 or for PayPal transactions
(not all processors support these transactions). |
| |
This
field is used to specify detail information using a serial tag format. See
the DETAILS field for other formats. I_DCD_0 is true if the first item is
discounted, I_DCD_1 is true if the second item is discounted, etc. |
| |
Local
field/ reserved for future use |
| |
|
| |
Item
Description |
PC
Level 3/Detail Records |
A/N[127] |
| |
I_DSC_n |
CAP,SCREENED,PROMO |
| |
Transaction
details can be included for purchase card level 3 or for PayPal transactions
(not all processors support these transactions). |
| |
This
field is used to specify detail information using a serial tag format. See
the DETAILS field for other formats. I_DSC_0 represents the description for
the first item, I_DSC_1 represents the description for the second item, etc. |
| |
Supported
for PayPal only |
| |
|
| |
Item
Measure |
PC
Level 3/Detail Records |
A/N[12] |
| |
I_MSR_n |
PCE |
| |
Transaction
details can be included for purchase card level 3 or for PayPal transactions
(not all processors support these transactions). |
| |
This
field is used to specify detail information using a serial tag format. See
the DETAILS field for other formats. I_MSR_0 represents the unit of measure
for the first item, I_MSR_1 represents the unit of measure for the second
item, etc. |
| |
Local
field/ reserved for future use |
| |
|
| |
Item
Number/Product Code |
PC
Level 3/Detail Records |
A/N[127] |
| |
I_NBR_n |
CAP-238-LOGO |
| |
Transaction
details can be included for purchase card level 3 or for PayPal transactions
(not all processors support these transactions). |
| |
This
field is used to specify detail information using a serial tag format. See
the DETAILS field for other formats. I_NBR_0 represents the item number for
the first item, I_NBR_1 represents the item number for the second item, etc. |
| |
Supported
for PayPal only |
| |
|
| |
Item
Options |
PC
Level 3/Detail Records |
A/N[127] |
| |
I_OPT_n |
None |
| |
Transaction
details can be included for purchase card level 3 or for PayPal transactions
(not all processors support these transactions). |
| |
This
field is used to specify detail information using a serial tag format. See
the DETAILS field for other formats. I_OPT_0 represents optional information
for the first item, I_OPT_1 represents optional information for the second
item, etc. |
| |
Supported
for PayPal only |
| |
|
| |
Item
Quantity |
PC
Level 3/Detail Records |
N[9] |
| |
I_QTY_n |
12 |
| |
Transaction
details can be included for purchase card level 3 or for PayPal transactions
(not all processors support these transactions). |
| |
This
field is used to specify detail information using a serial tag format. See
the DETAILS field for other formats. I_QTY_0 represents the quantity of the
first item, I_QTY_1 represents the quantity of the second item, etc. |
| |
Supported
for PayPal only |
| |
|
| |
Item
Tax |
PC
Level 3/Detail Records |
N[12] |
| |
I_TAX_n |
2.16 |
| |
Transaction
details can be included for purchase card level 3 or for PayPal transactions
(not all processors support these transactions). |
| |
This
field is used to specify detail information using a serial tag format. See
the DETAILS field for other formats. I_TAX_0 represents the tax for the first
item, I_TAX_1 represents the tax for the second item, etc. |
| |
Supported
for PayPal only |
| |
|
| |
Item
Tax Rate |
PC
Level 3/Detail Records |
N[9] |
| |
I_TXR_n |
0.05 |
| |
Transaction
details can be included for purchase card level 3 or for PayPal transactions
(not all processors support these transactions). |
| |
This
field is used to specify detail information using a serial tag format. See
the DETAILS field for other formats. I_TXR_0 represents the tax rate for the
first item, I_TXR_1 represents the tax rate for the second item, etc. |
| |
Local
field/ reserved for future use |
| |
|
| |
Item
Unit Cost |
PC
Level 3/Detail Records |
N[12] |
| |
I_UAM_n |
4 |
| |
Transaction
details can be included for purchase card level 3 or for PayPal transactions
(not all processors support these transactions). |
| |
This
field is used to specify detail information using a serial tag format. See
the DETAILS field for other formats. I_UAM_0 represents the unit cost for the
first item, I_UAM_1 represents the unit cost for the second item, etc. |
| |
Local
field/ reserved for future use |
| |
|
| |
Item
Total Includes Tax |
PC
Level 3/Detail Records |
1|0 |
| |
I_XIN_n |
1 |
| |
Transaction
details can be included for purchase card level 3 or for PayPal transactions
(not all processors support these transactions). |
| |
This
field is used to specify detail information using a serial tag format. See
the DETAILS field for other formats. I_XIN_0 is true if the first item
includes tax, I_XIN_1 is true if the second item includes tax, etc. |
| |
Local
field/ reserved for future use |
| |
|
| |
Item
Tax Type |
PC
Level 3/Detail Records |
A/N[12] |
| |
I_XTY_n |
MA |
| |
Transaction
details can be included for purchase card level 3 or for PayPal transactions
(not all processors support these transactions). |
| |
This
field is used to specify detail information using a serial tag format. See
the DETAILS field for other formats. I_XTY_0 represents the tax type for the
first item, I_XTY_1 represents the tax type for the second item, etc. |
| |
Local
field/ reserved for future use |
| |
|
| |
KSN |
Debit
Cards |
A/N[16] |
| |
KSN |
1.23457E+14 |
| |
For
debit card transactions. Key Sequence Number (KSN) associated with the PIN
pad that encrypted the customer's PIN. |
| |
Local
field/ reserved for future use |
| |
|
|
Last Action
Succeeded |
Common
Response Fields |
1|0 |
| LastActionSucceeded |
LAS |
1 |
| |
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 work
with CN!Express. Use ASIRESP for more specific information. |
| |
Supported
for all processors |
| |
|
| |
Merchant
Action |
Common
Response Fields |
A/N[10] |
| Merchant
Action |
MACTION |
| |
This
is a suggested action a merchant could take in response to a specific type of
transaction decline. |
| |
This
field is generated by CN!Express. These are the values that can be returned: |
| |
MACTION |
Description |
|
| |
CALL |
Call
payment processor for assistance with this transaction |
|
| |
DECLINE |
Decline
the transaction |
|
| |
ERROR |
Correct
the transaction and retry |
|
| |
RETRY |
Retry
the transaction at a later time |
|
| |
VOICE |
Obtain
a voice authorization |
|
| |
Supported
for: Chase Paymentech Orbital Gateway,PayPal,Trident Payment Gateway |
| |
|
| |
Market
Specific Data |
Additional
Credit Card |
A/N[1] |
| |
MARKSPEC |
B |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
MC
Banknet Date |
Credit
Card Authorization Specifics |
A/N[4] |
| |
MCBNKDAT |
301 |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
MC
Banknet Reference Number |
Credit
Card Authorization Specifics |
A/N[9] |
| |
MCBNKREF |
MWCYW4EDK |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
MCC |
Additional
Credit Card |
A/N[4] |
| |
MCC |
1234 |
| |
Used
to describe merchant's primary business. Usually set up at the division
level. |
| |
Supported
for: Chase Paymentech Orbital Gateway,Trident Payment Gateway,Transfirst ePay |
| |
|
| |
MC
SecureCode AAV |
VbV/Secure
Code |
A/N[32] |
| MC SecureCode
AAV |
MCSCAAV |
AAV |
| |
MasterCard
SecureCode Account holder Authentication Value. This is a unique transaction
token generated by the issuer and presented to the merchant each time a card
holder conducts an electronic transaction using MasterCard SecureCode. AAV
incorporates elements specific to the transaction and effectively binds the
cardholder to a transaction at a particular merchant for a given sale amount. |
| |
|
| |
Must
be sent in Base 64 Encoding. This is the same format used by MasterCard when
returning the AAV data to the merchant during the authentication step. |
| |
Supported
for Chase Paymentech Orbital Gateway only |
| |
|
| |
MC
Secure Code Support |
VbV/Secure
Code |
1|0 |
| |
MCSCSPT |
1 |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
Merchant
Promotional Code |
Bill
Me Later |
A/N[4] |
| |
MCTPROMO |
3004 |
| |
Used
by Bill Me Later. |
| |
Optional
value indicating a merchant special promotion code to which customer
responded. |
| |
Local
field/ reserved for future use |
| |
|
| |
Merchant
Customer Service Phone Number |
Merchant
Info/Soft Descriptors |
A/N[20] |
| |
MRCHCSPH |
8001234567 |
| |
Merchant
customer support phone number. Usually set up at the division level. |
| |
Supported
for: Trident Payment Gateway,Transfirst ePay |
| |
|
| |
Merchant
Order Number |
Common
Request Fields |
A/N[40] |
| Order Number |
MRCHORDR |
MRCHORDR-9012345678901234 |
| |
The
merchant order number represents the order associated with this transaction.
Often, the merchant order number is the best way to look up a transaction
when handling exceptions or when discussing a transaction with the payment
processor. The merchant order number should be unique for each transaction. |
| |
|
| |
Different
payment processors have different rules about the number of characters for an
order number, or about what types of characters are acceptable. If possible,
ASI recommends that you follow these guidelines so that your order numbers
will meet the requirements of even the most restrictive systems: |
| |
|
| |
Order
numbers should be 22 characters in length or shorter. |
| |
Order
numbers should be unique within the first eight digits. |
| |
Use
only upper and lowercase alpha and numeric characters, plus the following:
-,$@ |
| |
Pinless
debit order numbers must use alphanumerics only. |
| |
|
| |
Supported
for: Chase Paymentech Orbital Gateway,Trident Payment Gateway,Transfirst ePay |
| |
|
| |
Merchant
State/Prov Descriptor |
Merchant
Info/Soft Descriptors |
A/N[2] |
| |
MSTATE |
NH |
| |
State
or province part of merchant location. |
| |
Supported
for Trident Payment Gateway only |
| |
|
| |
Merchant
ZIP/Postal Code |
Merchant
Info/Soft Descriptors |
A/N[10] |
| |
MZCPC |
3458 |
| |
Zip
code or postal code part of merchant location. |
| |
Supported
for Trident Payment Gateway only |
| |
|
| |
Net
Amount |
PayPal |
N[12] |
| |
NETAMT |
4 |
| |
The
net amount of the transaction. Returned by PayPal in response to a query
transaction. |
| |
Supported
for PayPal only |
| |
|
| |
Operating
Environment |
Additional
Credit Card |
A/N[1] |
| |
OPENV |
0 |
| |
Describes
the terminal operating environment. |
| |
American
Express only. This is additional information that you can specify to describe
the transaction environment. |
| |
Local
field/ reserved for future use |
| |
|
| |
Order
Date |
Other |
M/D/YYYY |
| Order Date |
ORDDATE |
39142 |
| |
The
date on which an order was created using OpenOrder (as returned by PayPal). |
| |
Supported
for PayPal only |
| |
|
| |
Order
Time |
Other |
H:M:S |
| |
ORDTIME |
0.598969907 |
| |
The
time at which an order was created using OpenOrder (as returned by PayPal). |
| |
Supported
for PayPal only |
| |
|
| |
Original
Authorized Amount |
Credit
Card Authorization Specifics |
N[12] |
| |
ORIGAUTH |
1 |
| |
Amount
of initial authorization. |
| |
Local
field/ reserved for future use |
| |
|
| |
PIN
Capture Capability |
Additional
Credit Card |
A/N[1] |
| |
PCAPCAPB |
0 |
| |
Describes
the PIN capture capability of the terminal. |
| |
American
Express only. This is additional information that you can specify to describe
the transaction environment. |
| |
Local
field/ reserved for future use |
| |
|
| |
Pended |
PayPal |
1|0 |
| |
PENDED |
0 |
| |
A
boolean value returned in a GetDetails response which tells whether or not a
transaction is in pending status. |
| |
Supported
for PayPal only |
| |
|
| |
Pended
Text |
PayPal |
A/N[20] |
| |
PENDTEXT |
verify |
| |
Returned
by PayPal in a GetDetails response which describes the reason a transaction
is pending. |
| |
Supported
for PayPal only |
| |
|
| |
Presenter
ID |
Other |
A/N[6] |
| |
PID |
123456 |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
PIN |
Debit
Cards |
A/N[16] |
| |
PIN |
1.23457E+14 |
| |
Debit
Card encrypted Personal Identification Number (PIN) entered by customer. |
| |
Supported
for Chase Paymentech Orbital Gateway only |
| |
|
| |
Payment
Number |
Recurring/Installment |
N[2] |
| Installment
Number |
PMTNBR |
1 |
| |
For
recurring or installment transactions, the number of this payment in the
series of payments. |
| |
Supported
for: Chase Paymentech Orbital Gateway,Transfirst ePay |
| |
|
| |
PO
Number |
PC
Level 2 |
A/N[17] |
| PO Number |
PONUM |
PO-23456789 |
| |
Customer
Purchase Order Number. |
| |
This
field is required for purchase card level 2 and purchase card level 3
transactions. |
| |
Supported
for: Chase Paymentech Orbital Gateway,Trident Payment Gateway |
| |
|
| |
POP
Terminal City |
POP/Arc |
A/N[4] |
| |
POPCITY |
BOS |
| |
City
where Point of Purchase terminal is located. Optional. |
| |
Used
only for POP transactions. |
| |
Local
field/ reserved for future use |
| |
|
| |
POP
Terminal State |
POP/Arc |
A/N[2] |
| |
POPSTATE |
MA |
| |
State
where Point of Purchase terminal is located. Optional. |
| |
Used
only for POP transactions. |
| |
Local
field/ reserved for future use |
| |
|
| |
POS
Capability Code |
Retail |
0|1|2|C|K|L|N|X |
| |
POSCAP |
K |
| |
Describes
the capabilities of the POS device. Optional. |
| |
This
is additional information that you can specify to describe the transaction
environment. Including this information may improve the interchange rate for
this transaction. Contact payment processor for specific requirements. |
| |
Value |
Description |
|
| |
1 |
Track
1 |
|
| |
2 |
Track
2 |
|
| |
C |
Chip |
|
| |
K |
Keyed |
|
| |
L |
Contactless |
|
| |
Supported
for Transfirst ePay only |
| |
|
| |
POS
Entry Mode |
Retail |
0|1|2|C|E|K|L|M|N|S|U|V|W|X|Y |
| |
POSENTRY |
K |
| |
Describes
how the transaction was entered. |
| |
This
is additional information that you can specify to describe the transaction
environment. Including this information may improve the interchange rate for
this transaction. Contact payment processor for specific requirements. |
| |
Value |
Description |
|
| |
1 |
Track
1 |
|
| |
2 |
Track
2 |
|
| |
C |
Chip |
|
| |
E |
Ecommerce |
|
| |
K |
Keyed |
|
| |
L |
Contactless |
|
| |
M |
Track
1 and 2 |
|
| |
U |
Chip
Card (CVV unreliable) |
|
| |
V |
Contactless
Chip |
|
| |
Supported
for Transfirst ePay only |
| |
|
| |
POS
Customer ID Method |
Retail |
0|M|P|S|T|U |
| |
POSID |
M |
| |
Describes
how the cardholder was identified. |
| |
This
is additional information that you can specify to describe the transaction
environment. Including this information may improve the interchange rate for
this transaction. Contact payment processor for specific requirements. |
| |
Value |
Description |
|
| |
M |
Mailorder |
|
| |
P |
PIN |
|
| |
S |
Signature |
|
| |
U |
Unattended |
|
| |
Supported
for Transfirst ePay only |
| |
|
| |
Pre-approval
Invitation Number |
Bill
Me Later |
A/N[16] |
| |
PREAPRNO |
123456789ABCDEF |
| |
Used
for Bill Me Later. |
| |
Indicates
whether or not customer has been pre-approved. |
| |
|
| |
Pre-approval
from credit bureau should include the 16-digit pre-approval number. This
allows the pre-approval to be matched with the first customer order. |
| |
Internal
pre-approval should include the leftmost digit as 1. |
| |
No
pre-approval should include all zeros or be blank. |
| |
|
| |
Local
field/ reserved for future use |
| |
|
| |
Processor-Specific
Attribute 1 |
Processor
Specifics |
A/N[32] |
| |
PROCATR1 |
proc-attr-1 |
| |
Processor-specific.
Has the following definitions for each processor. |
| |
|
| |
Chase
Paymentech Orbital Gateway |
| |
PROCATR1
is a retry key. You can use this value to uniquely identify a certain
transaction through multiple retries. To do so, store the response from this
field. If a transaction must be retried, return the response as PROCATR1 with
the new submission to CN!Express. |
| |
PayPal |
| |
PROCATR1
is the parent transaction ID, the PayPal transaction ID of the preceding
transaction in a sequence. Provided for tracking purposes only. |
| |
|
| |
Supported
for all processors |
| |
|
| |
Processor-Specific
Attribute 2 |
Processor
Specifics |
A/N[32] |
| |
PROCATR2 |
proc-attr-2 |
| |
Processor-specific.
Has the following definitions for each processor. |
| |
|
| |
PayPal |
| |
PROCATR2
is the PayPal TransactionType. Returned by GetDetails and Query transactions.
Some examples are cart or virtual-terminal. |
| |
|
| |
Supported
for PayPal only |
| |
|
| |
Processor-Specific
Attribute 3 |
Processor
Specifics |
A/N[32] |
| |
PROCATR3 |
proc-attr-3 |
| |
Processor-specific.
Has the following definitions for each processor. |
| |
|
| |
PayPal |
| |
PROCATR3
is the PayPal ReceiptID. Can be sent to CN!Express as a search parameter for
a Query transaction, or returned by PayPal in response to a GetDetails
transaction. |
| |
|
| |
Supported
for PayPal only |
| |
|
| |
Processor-Specific
Attribute 4 |
Processor
Specifics |
A/N[32] |
| |
PROCATR4 |
proc-attr-4 |
| |
Processor-specific.
Has the following definitions for each processor. |
| |
|
| |
PayPal |
| |
PROCATR4
is the PayPal PaymentType. Indicates whether a payment is instant or delayed. |
| |
|
| |
Supported
for PayPal only |
| |
|
| |
Processor
Division ID |
Processor
Specifics |
A/N[20] |
| |
PROCDIV |
123456 |
| |
The
processor's division number or processor-specific Merchant ID. If you have
only one CN!Express division set up, you can use this to directly assign
individual transactions to processor divisions. |
| |
Supported
for Chase Paymentech Orbital Gateway only |
| |
|
| |
Processor
Fee |
Processor
Specifics |
N[12] |
| |
PROCFEE |
1 |
| |
Fee
charged for transaction. Returned by GetDetails and Query transactions. |
| |
Supported
for PayPal only |
| |
|
| |
Payment
Processor Mode |
Processor
Specifics |
D|T|P |
| |
PROCMODE |
P |
| |
The
mode for this transaction. |
| |
Mode |
Description |
|
| |
D |
Demo
Mode. For setup/demo only. Handled internally by CN!Express and never sent to
payment processor. |
|
| |
P |
Production
Mode. Sent to the payment processor in production mode. |
|
| |
T |
Test
Mode. Sent to the payment processor using the payment processor's test mode. |
|
| |
Supported
for all processors |
| |
|
| |
Processor
Order ID |
Identifiers |
A/N[40] |
| |
PROCORDR |
28269684AF474914S |
| |
The
processor order number for this transaction. |
| |
Supported
for: PayPal,Transfirst ePay |
| |
|
| |
Processor
Status |
PayPal |
A/N[20] |
| |
PROCSTAT |
Completed |
| |
A
text description of the status of the transaction, as maintained by the
processor. Can be used as a search parameter for Query transactions. |
| |
Supported
for PayPal only |
| |
|
| |
Processor
Transaction ID |
Identifiers |
A/N[50] |
| TxRefIdx ,
TxRefNum |
PROCTID |
7AWDEGTR012345678 |
| |
The
processor transaction ID. Uniquely identifies a transaction for a given
processor. 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 all processors |
| |
|
| |
Product
Delivery Type |
Shipment
Address/Info |
1|D|P|V|T |
| |
PRODTYPE |
P |
| |
Describes
how the product being purchased is to be delivered. |
| |
CN!Express |
Chase
Paymentech |
Description |
| |
Code |
Code |
| |
D |
DIG |
Digital
Goods, ex: Downloaded software or Ebook (Visa/BML) |
| |
P |
PHY |
Physical
(Visa/BML) |
| |
T |
TBD |
To
Be Determined (BML) |
| |
V |
SVC |
Service
(BML) |
| |
Y |
CNC |
Cash
and Carry (BML) |
| |
Local
field/ reserved for future use |
| |
|
| |
PayPal
Address Owner |
PayPal |
A/N[50] |
| |
PYADRONR |
Owner
Corp. |
| |
PayPal
only. eBay company that maintains this address. |
| |
Supported
for PayPal only |
| |
|
| |
PayPal
Address Status |
PayPal |
A/N[50] |
| |
PYADRSTA |
Confirmed. |
| |
PayPal
only. Text status of this address with PayPal. |
| |
Supported
for PayPal only |
| |
|
| |
PayPal
Contract ID |
PayPal |
A/N[20] |
| |
PYCID |
7IKLQNJS012345678901 |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
PayPal
PayerID |
PayPal |
A/N[13] |
| |
PYPAYER |
95HR9CM6D56Q2 |
| |
The
PayPal PayerID. Required field (along with PYTOKEN) for PayPal Authorization,
Sale, or CreateOrder. |
| |
Supported
for PayPal only |
| |
|
| |
PayPal
API Password |
PayPal |
A/N[64] |
| |
PYPWD |
QFZCWN5HZM8VBG7Q |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
PayPal
API Signature |
PayPal |
A/N[64] |
| |
PYSIG |
A-IzJhZZjhg29XQ2qnhapuwxIDzyAZQ92FRP5dqBzVesOkzbdUONzmOU |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
PayPal
Token |
PayPal |
A/N[20] |
| |
PYTOKEN |
EC-0E881823PA052770A |
| |
The
PayPal Token. Required field (along with PYPAYER) for PayPal Authorization,
Sale, or CreateOrder. |
| |
Supported
for PayPal only |
| |
|
| |
PayPal
API User |
PayPal |
A/N[64] |
| |
PYUSER |
example.com |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
Query
Class |
PayPal |
A/N[32] |
| |
QRYCLASS |
All |
| |
The
PayPal TransactionClass. May be used as a search parameter with a Query
transaction. Some examples include All and BalanceAffecting. See PayPal documentation for complete list. |
| |
Supported
for PayPal only |
| |
|
| |
Qual
Key |
Separate
Auth/Capture |
A/N[32] |
| |
QUALKEY |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
Retail
Auth Terminal ID |
Retail |
A/N[8] |
| |
RAUTHTID |
1234567 |
| |
The
terminal ID for the authorizing terminal in a POS environment. Optional. |
| |
Supported
for Transfirst ePay only |
| |
|
| |
Recurring
Payment Advice Code |
Recurring/Installment |
01|02|03 |
| Recurring
Payment Advice Code |
RECADV |
1 |
| |
Action
to be taken when receiving decline on a transaction marked as recurring. Will
be one of the following: |
| |
Action |
Description |
|
| |
1 |
New
account information available. Obtain new account information. |
|
| |
2 |
Try
again later. Recycle transaction in 72 hours. |
|
| |
3 |
Do
not try again. Obtain another type of payment from customer. |
|
| |
|
| |
Code
returned only for MasterCard account numbers. The Transaction Class must be
set to Recurring (see the Class field). |
| |
Supported
for Chase Paymentech Orbital Gateway only |
| |
|
| |
Customer
Registration Date |
Bill
Me Later |
M/D/YYYY |
| |
REGDATE |
38366 |
| |
Used
for Bill Me Later. |
| |
Date
the customer registered with the merchant. |
| |
Local
field/ reserved for future use |
| |
|
| |
Requested
ACI |
Credit
Card Authorization Specifics |
Y|R|I|P |
| |
REQDACI |
Y |
| |
Returned
Authorization Characteristics Indicator. |
| |
This
value indicates the ACI value that was requested at authorization time. This
is currently for documentation only. |
| |
Local
field/ reserved for future use |
| |
|
| |
Response
Code |
Common
Response Fields |
A/N[6] |
| Response Code |
RESPCODE |
100 |
| |
The
processor-specific response code. These can be used to programatically
determine the disposition of a transaction, but the merchant system must be
able to handle new response codes. ASI recommends that you use the normalized
ASIRESP code for this purpose. |
| |
Supported
for all processors |
| |
|
| |
Response
Date and Time |
Common
Response Fields |
M/D/YYYY
[H:M:S] |
| Response Date |
RESPDATE |
39142.59897 |
| |
Date
and Time the transaction was processed. |
| |
Supported
for all processors |
| |
|
| |
Response
Text |
Common
Response Fields |
A/N[255] |
| Response Text |
RESPTEXT |
100
-- Approved |
| |
Text
description of the transaction result. |
| |
Supported
for all processors |
| |
|
| |
Response
Timezone |
PayPal |
A/N[3] |
| |
RESPTZ |
GMT |
| |
Time
zone of a transaction. Can be used as a Query input parameter. |
| |
Supported
for PayPal only |
| |
|
| |
Returned
ACI |
Credit
Card Authorization Specifics |
A/N[1] |
| |
RETRACI |
V |
| |
This
value is returned by Visa in the original Authorization transaction. |
| |
Can
be stored and optionally returned with the deposit transaction. |
| |
Supported
for Transfirst ePay only |
| |
|
| |
Retrieval
Reference Number |
Credit
Card Authorization Specifics |
A/N[12] |
| |
RETRREF |
12345678901 |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
Fee
Refunded |
PayPal |
N[12] |
| |
RFFEEAMT |
1 |
| |
Returned
for refund transactions. Transaction fee refunded to merchant. |
| |
Supported
for PayPal only |
| |
|
| |
Gross
Refunded Amount |
PayPal |
N[12] |
| |
RFGRAMT |
5 |
| |
Returned
for refund transactions. Amount of money refunded to payer. |
| |
Supported
for PayPal only |
| |
|
| |
Receiving
Institution ID |
Credit
Card Authorization Specifics |
A/N[6] |
| |
RIID |
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 |
| |
|
| |
Routing
Number |
Checks |
A/N[9] |
| Routing
Number |
ROUTNUM |
123456789 |
| |
Bank
routing number for checks. Also called Receiving Depository Financial
Institution (RDFI) number, the Bank ID, the ABA#, or the Transit Routing #.
US bank values are 9 digits. Canadian bank values are 8 digits. For Canadian
banks, the first 8 characters should not have a space or dash. The proper
formatting of Canadian bank IDs is FFFBBBBB where FFF is the financial
institution and BBBBB is the branch number. |
| |
Supported
for Chase Paymentech Orbital Gateway only |
| |
|
| |
Retail
Settle Batch ID |
Retail |
A/N[16] |
| |
RSETLBID |
1.23457E+14 |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
Retail
Settle Terminal ID |
Retail |
A/N[16] |
| |
RSETLTID |
1.23457E+14 |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
Reversal
Text |
PayPal |
A/N[20] |
| |
RVRSTEXT |
chargeback |
| |
Returned
for a GetDetails transaction if the status of the transaction is Reversed. A
text description of why the transaction was reversed. |
| |
Supported
for PayPal only |
| |
|
| |
Sales
Tax |
PayPal |
N[12] |
| |
SALESTAX |
1 |
| |
Returned
for a GetDetails transaction. The amount of sales tax on the purchase. |
| |
Supported
for PayPal only |
| |
|
| |
Seller
AccountID |
PayPal |
A/N[50] |
| |
SELLACCT |
1234565 |
| |
Returned
for a GetDetails transaction. Account number of the seller. |
| |
Supported
for PayPal only |
| |
|
| |
Seller
Contact Information |
PayPal |
A/N[50] |
| |
SELLCNTC |
service@example.com |
| |
Returned
for a GetDetails transaction. Email address or account ID of the seller. |
| |
Supported
for PayPal only |
| |
|
| |
Seller
Email |
PayPal |
A/N[50] |
| |
SELLEMAL |
tkseller@example.com |
| |
Returned
for a GetDetails transaction. Email address of the seller. |
| |
Supported
for PayPal only |
| |
|
| |
Service
Development |
Additional
Credit Card |
A/N[1] |
| |
SERVDEV |
7 |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
Ship
From ZIP/Postal Code |
PC
Level 2 |
A/N[10] |
| Ship From
Zip/PC |
SFRMZCPC |
03458-1234 |
| |
Zip
code or Canadian postal code from which product was shipped. |
| |
Supported
for Transfirst ePay only |
| |
|
| |
ShipAddress:Address
1 |
Shipment
Address/Info |
A/N[100] |
| ShipAddress:Address1 |
SHIPADD1 |
44
Shipper Lane |
| |
First
address line of customer shipping address. |
| |
Supported
for: Chase Paymentech Orbital Gateway,PayPal |
| |
|
| |
ShipAddress:Address
2 |
Shipment
Address/Info |
A/N[100] |
| ShipAddress:Address2 |
SHIPADD2 |
PO
Box 44 |
| |
Second
address line of customer shipping address. |
| |
Supported
for: Chase Paymentech Orbital Gateway,PayPal |
| |
|
| |
ShipAddress:Apt |
Shipment
Address/Info |
A/N[6] |
| ShipAddress:Apt |
SHIPAPT |
44 |
| |
Apartment
portion of customer shipping address. |
| |
Local
field/ reserved for future use |
| |
|
| |
Shipping
Carrier |
Shipment
Address/Info |
A/N[4] |
| |
SHIPCAR |
USPS |
| |
Carrier
delivering the merchandise to customer. |
| |
Carrier |
Description |
|
| |
DHL |
DHL |
|
| |
FEDX |
Federal
Express |
|
| |
G |
Greyhound |
|
| |
O |
Other |
|
| |
P |
Purolator |
|
| |
USPS |
United
States Postal Service |
|
| |
UPS |
United
Parcel Service |
|
| |
Local
field/ reserved for future use |
| |
|
| |
ShipAddress:City |
Shipment
Address/Info |
A/N[40] |
| ShipAddress:City |
SHIPCITY |
Peterborough |
| |
City
portion of customer shipping address. |
| |
Supported
for: Chase Paymentech Orbital Gateway,PayPal |
| |
|
| |
ShipAddress:Company |
Shipment
Address/Info |
A/N[50] |
| |
SHIPCO |
Example
Corp. |
| |
Company
portion of customer shipping address. |
| |
Local
field/ reserved for future use |
| |
|
| |
ShipAddress:Country |
Shipment
Address/Info |
A/N[3] |
| ShipAddress:Country |
SHIPCTRY |
US |
| |
Country
portion of customer shipping address. Use two-letter country code of
destination country. |
| |
Supported
for PayPal only |
| |
|
| |
Ship
Date |
Shipment
Address/Info |
M/D/YYYY |
| |
SHIPDATE |
39142 |
| |
Date
product was shipped to fulfill the order. |
| |
Supported
for Transfirst ePay only |
| |
|
| |
ShipAddress:Email |
Shipment
Address/Info |
A/N[50] |
| ShipAddress:Email |
SHIPEMAL |
mbjones@example.com |
| |
Email
portion of customer shipping address. |
| |
Example:
customer@example.com. |
| |
Local
field/ reserved for future use |
| |
|
| |
ShipAddress:First
Name |
Shipment
Address/Info |
A/N[40] |
| ShipAddress:FirstName |
SHIPFNAM |
Mary |
| |
Recipient's
first name. Specify either the name components (e.g., SHIPFNAM, SHIPMI,
SHIPLNAM) or the full name (SHIPNAME), depending on how these fields are used
in your implementation. |
| |
Supported
for PayPal only |
| |
|
| |
ShipAddress:Home
Phone |
Shipment
Address/Info |
A/N[20] |
| ShipAddress:HomePhone |
SHIPHPHO |
6035554444 |
| |
Home
phone portion of customer shipping address. |
| |
Supported
for PayPal only |
| |
|
| |
ShipAddress:Last
Name |
Shipment
Address/Info |
A/N[40] |
| ShipAddress:LastName |
SHIPLNAM |
Jones |
| |
Recipient's
last name. Specify either the name components (e.g., SHIPFNAM, SHIPMI,
SHIPLNAM) or the full name (SHIPNAME), depending on how these fields are used
in your implementation. |
| |
Supported
for PayPal only |
| |
|
| |
Shipping
Method |
Shipment
Address/Info |
C|D|E|G|I|M|N|O|P|S|T|W |
| |
SHIPMETH |
N |
| |
Method
by which purchase is shipped to customer. |
| |
Method |
Description |
|
| |
C |
Lowest
Cost |
|
| |
D |
Carrier
Designated |
|
| |
E |
Electronic |
|
| |
G |
Ground |
|
| |
I |
International |
|
| |
M |
Military |
|
| |
N |
Next
Day |
|
| |
O |
Other |
|
| |
P |
Pick
up |
|
| |
S |
Same
Day |
|
| |
T |
Two
Day |
|
| |
W |
Three
Day |
|
| |
Local
field/ reserved for future use |
| |
|
| |
ShipAddress:Middle
Initial |
Shipment
Address/Info |
A/N[5] |
| ShipAddress:MiddleInitial |
SHIPMI |
B |
| |
Recipient'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 SHIPLNAM field |
| |
Local
field/ reserved for future use |
| |
|
| |
Ship-To
Full Name |
Shipment
Address/Info |
A/N[30] |
| |
SHIPNAME |
Mary
Jones |
| |
Recipient's
full name. Specify either the name components (e.g., SHIPFNAM, SHIPMI,
SHIPLNAM) or the full name (BILLNAME), depending on how these fields are used
in your implementation. |
| |
Supported
for: Chase Paymentech Orbital Gateway,PayPal |
| |
|
| |
ShipAddress:Salutation |
Shipment
Address/Info |
A/N[20] |
| |
SHIPSALU |
Ms. |
| |
The
shipping name salutation (e.g., "Mr.") |
| |
Local
field/ reserved for future use |
| |
|
| |
ShipAddress:State/Prov |
Shipment
Address/Info |
A/N[40] |
| ShipAddress:State/Prov |
SHIPSTPR |
NH |
| |
US
State or Canadian Province Code portion of shipping address. |
| |
Supported
for: Chase Paymentech Orbital Gateway,PayPal |
| |
|
| |
ShipAddress:Shuffix |
Shipment
Address/Info |
A/N[12] |
| |
SHIPSUFX |
Jr. |
| |
The
shipping name suffix (e.g., "Jr.") |
| |
Local
field/ reserved for future use |
| |
|
| |
ShipAddress:Work
Phone |
Shipment
Address/Info |
A/N[20] |
| ShipAddress:WorkPhone |
SHIPWPHO |
6034444444 |
| |
|
|
|
| |
|
|
|
| |
|
|
|
| |
|
|
|
| |
Work
phone number of shipping address. |
| |
Local
field/ reserved for future use |
| |
|
| |
ShipAddress:ZIP/Postal
Code |
Shipment
Address/Info |
A/N[20] |
| ShipAddress:Zip/Postal
Code |
SHIPZCPC |
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,PayPal,Trident Payment Gateway |
| |
|
| |
SubmitterID |
Other |
A/N[6] |
| |
SID |
123456 |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
SKU |
Shipment
Address/Info |
A/N[15] |
| |
SKU |
SKU
NUMBER |
| |
Merchant's
SKU number. |
| |
Local
field/ reserved for future use |
| |
|
| |
Soft
Descriptor 1 |
Merchant
Info/Soft Descriptors |
A/N[25] |
| Soft
Descriptor 1 |
SOFT1 |
ASI*TREVANCE
GATEWAY |
| |
Generally,
a description of the payment that appears on the customer statement. This
field is used in different ways for different processors. |
| |
|
| |
Chase
Paymentech Orbital Gateway |
| |
This
field is used for both credit card and electronic check transactions. |
| |
|
| |
This
description appears on the customer's statement. If this field is blank,
Chase Paymentech uses the default descriptor set for the Division. |
| |
|
| |
Credit
Cards |
| |
The
Merchant Name Descriptor field must not start with a space. |
| |
There
are three acceptable formats: |
| |
|
| |
A
three (3) character company identifier, followed by an asterisk (*), and up
to 18 character description. |
| |
A
seven (7) character company identifier, followed by an asterisk (*), and up
to 14 character descriptor. |
| |
A 12
character company identifier, followed by an asterisk (*), and up to nine (9)
character descriptor. |
| |
|
| |
The
asterisk must be in position 4, 8, or 13. If necessary add spaces between the
company name and the asterisk. |
| |
|
| |
Electronic
Checks |
| |
For
Electronic Check Transactions, the first 15 characters of this field should
be used as the Doing Business As (DBA) Merchant Name. |
| |
Both
Descriptor fields are required when using descriptors with electronic checks. |
| |
Transfirst
ePay |
| |
A
25-digit payment descriptor which will appear on the cardholder's statement. |
| |
Trident
Payment Gateway |
| |
DBA
name of the merchant. See also SOFT2, MSTATE, and MZCPC. |
| |
|
| |
Supported
for: Chase Paymentech Orbital Gateway,Trident Payment Gateway,Transfirst ePay |
| |
|
| |
Soft
Descriptor 2 |
Merchant
Info/Soft Descriptors |
A/N[13] |
| Soft
Descriptor 2 |
SOFT2 |
800-123-1234 |
| |
Generally,
merchant contact information that appears on the customer statement. This
field is used in different ways for different processors. |
| |
|
| |
Chase
Paymentech Orbital Gateway |
| |
City
or customer service phone number that will appear on the cardholder's
statement. |
| |
If
left blank, will default to the value set at Chase Paymentech. |
| |
This
field is used for both credit card and check transactions. |
| |
|
| |
Credit
Cards |
| |
The
Merchant city or customer service phone number that will appear on the
cardholder's statement. |
| |
Recommended
formats by merchant channel: |
| |
Retail |
Store
location city formatted as AAAAAAAAAAAAA |
|
| |
Direct
Marketing |
Customer
Service Phone Number formatted as NNN-NNN-NNNN or NNN-AAAAAAA |
|
| |
|
Store
URL |
|
| |
|
Support
Email address |
|
| |
Entering
the Customer Service Phone Number is a requirement to qualify for Visa's
reduced Direct Marketing interchange rate. |
| |
|
| |
Electronic
Checks |
| |
The
first ten (10) characters of this field (usually) appear on the customer's
statement. |
| |
Both
Descriptor fields are required when using descriptors with electronic checks. |
| |
Trident
Payment Gateway |
| |
DBA
city of the merchant. See also SOFT1, MSTATE, and MZCPC. |
| |
|
| |
Supported
for: Chase Paymentech Orbital Gateway,Trident Payment Gateway |
| |
|
| |
Source
IP Address |
ECommerce
Customer Info |
###.###.###.### |
| |
SOURCEIP |
192.168.123.123 |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| |
|
| |
Status |
Other |
A/N[20] |
| Status |
STATUS |
AUTHORIZED |
| |
Transaction
Status. |
| |
This
field is generated by CN!Express. |
| |
|
| |
Authorized |
| |
Closed |
| |
Captured |
| |
Entered |
| |
Failed |
| |
Refunded |
| |
Voided |
| |
|
| |
Supported
for PayPal only |
| |
|
| |
Start
Date |
PayPal |
M/D/YYYY
[H:M:S] |
| |
STRTDATE |
39142.59897 |
| |
For
Query transactions, the first date to include in the search. |
| |
Supported
for PayPal only |
| |
|
| |
Subscription
Date |
PayPal |
M/D/YYYY |
| |
SUBDATE |
39142 |
| |
Returned
by PayPal in response to a GetDetails transaction. The subscription start
date. |
| |
Supported
for PayPal only |
| |
|
| |
Subscription
Effective Date |
PayPal |
M/D/YYYY |
| |
SUBEFDT |
39142 |
| |
Returned
by PayPal in response to a GetDetails transaction. The subscription effective
date. |
| |
Supported
for PayPal only |
| |
|
| |
Subscriber
ID |
PayPal |
A/N[50] |
| |
SUBID |
123456 |
| |
Returned
by PayPal in response to a GetDetails transaction. The subscription ID. |
| |
Supported
for PayPal only |
| |
|
| |
Subscriber
Password |
PayPal |
A/N[128] |
| |
SUBPASS |
a8923ha89ha32 |
| |
Returned
by PayPal in response to a GetDetails transaction. The subscription password. |
| |
Supported
for PayPal only |
| |
|
| |
Subscription
Period |
PayPal |
A/N[50] |
| |
SUBPRD |
2
Years |
| |
Returned
by PayPal in response to a GetDetails transaction. The subscription period. |
| |
Supported
for PayPal only |
| |
|
| |
Subscription
Rate Recurring |
PayPal |
1|0 |
| |
SUBRECR |
1 |
| |
Returned
by PayPal in response to a GetDetails transaction. 1 if regular rate recurs. |
| |
Supported
for PayPal only |
| |
|
| |
Subscription
Retry |
PayPal |
1|0 |
| |
SUBRETR |
1 |
| |
Returned
by PayPal in response to a GetDetails transaction. Indicates whether
re-attempts occur on payment failures. |
| |
Supported
for PayPal only |
| |
|
| |
Subscription
Retry Date |
PayPal |
M/D/YYYY |
| |
SUBRTDT |
39142 |
| |
Returned
by PayPal in response to a GetDetails transaction. Date of retry on failed
payment attempt. |
| |
Supported
for PayPal only |
| |
|
| |
Subscriber
User Name |
PayPal |
A/N[64] |
| |
SUBUSER |
JDoe25 |
| |
Returned
by PayPal in response to a GetDetails transaction. The subscription user. |
| |
Supported
for PayPal only |
| |
|
| |
Surcharge
Amount |
Debit
Cards |
N[12] |
| |
SURCHAMT |
1 |
| |
Returned
by Debit Authorization Transaction. |
| |
Amount
of surcharge charged for this transaction. 0.00 if no surcharge. |
| |
Local
field/ reserved for future use |
| |
|
| |
Switch/Solo
Card Start Date |
Switch/Maestro |
A/N[4] |
| Switch/Solo
Start Date |
SWCHDATE |
105 |
| |
The
date the card becomes active. |
| |
Format:
MMYY |
| |
The
Switch/Solo Card Start Date field should be submitted only when the card does
not have an Issue Number. If the card displays only a Start Date and no Issue
Number, the Switch/Solo Card Start Date field should contain a value and the
Switch/Solo Card Issue Number field must be blank. If the card displays both
a Start Date and an Issue Number, the Card Start Date should be left blank
and the Card Issue Number field must be populated. |
| |
Local
field/ reserved for future use |
| |
|
| |
Switch/Solo
Card Issue Number |
Switch/Maestro |
A/N[2] |
| Switch/Solo
Issue Number |
SWCHISSU |
1 |
| |
An
increment counter of either 1 or 2 characters defined by the issuing bank. If
a card is lost, the bank issues a replacement card with the issue number
being increased by one. The Switch/Solo Card Issue Number must be submitted
even when a Switch/Solo Card Start Date exists. In addition, the Switch/Solo
Card Issue Number must be submitted exactly as sown on the card. |
| |
Example: |
| |
|
| |
If
the card displays "01", submit "01", NOT "1". |
| |
If
the card displays "1", submit "1", not "01" |
| |
|
| |
Local
field/ reserved for future use |
| |
|
| |
AMEX
Trans Advice 1 |
PC
Level 2 |
A/N[40] |
| AMEX Trans
Advice 1 |
TAA1 |
Advice1 |
| |
American
Express Transaction Advice Addendum #1. This record provides additional
purchase information for American Express transactions. It is also used for
Purchase Card transactions to provide specific details about the transaction
to the cardholder for tracking purposes. Information entered in this field
should be as specific as possible. MERCHANDISE, for example, is unacceptable.
APPLE MACINTOSH is acceptable. The text must be in uppercase. |
| |
Transaction
Advice Addendum (TAA) fields must be presented in sequence for them to be
transmitted. If two TAA fields are to be transmitted, they must be TAA#1 and
TAA#2. If TAA#1 and TAA#3 are presented, only TAA#1 is transmitted. |
| |
Supported
for Chase Paymentech Orbital Gateway only |
| |
|
| |
AMEX
Trans Advice 2 |
PC
Level 2 |
A/N[40] |
| AMEX Trans
Advice 2 |
TAA2 |
Advice2 |
| |
American
Express Transaction Advice Addendum #2. This is a test |
| |
Supported
for Chase Paymentech Orbital Gateway only |
| |
|
| |
AMEX
Trans Advice 3 |
PC
Level 2 |
A/N[40] |
| AMEX Trans
Advice 3 |
TAA3 |
Advice3 |
| |
American
Express Transaction Advice Addendum #3 |
| |
Supported
for Chase Paymentech Orbital Gateway only |
| |
|
| |
AMEX
Trans Advice 4 |
PC
Level 2 |
A/N[40] |
| AMEX Trans
Advice 4 |
TAA4 |
Advice4 |
| |
American
Express Transaction Advice Addendum #4 |
| |
Supported
for Chase Paymentech Orbital Gateway only |
| |
|
| |
T
and C Version |
Bill
Me Later |
A/N[5] |
| |
TANDC |
2102 |
| |
Used
for Bill Me Later transactions. |
| |
Version
number of the Terms and Conditions to which the customer agreed. |
| |
Local
field/ reserved for future use |
| |
|
|
Tax |
PC
Level 2 |
N[12] |
| Tax |
TAX |
1 |
| |
This
value is required for purchase card level 2 and purchase card level 3
transactions. |
| |
Supported
for all processors |
| |
|
|
Tax Exempt |
PC
Level 2 |
1|0 |
| Tax Exempt |
TAXEXMPT |
0 |
| |
This
value is required for purchase card level 2 and purchase card level 3
transactions. 'Y' if transaction is tax exempt, 'N' if not. If not supplied
but TAX is supplied, 'N' is assumed. |
| |
Supported
for: Chase Paymentech Orbital Gateway,Transfirst ePay |
| |
|
|
Tender Type |
Common
Request Fields |
C|P|K|D|L |
| Tender Type |
TENDTYPE |
C |
| |
CN!Express
always assumes the incoming transaction is a credit card transaction. |
| |
It
can then automatically distinguish check, PIN-based Debit, and Bill Me Later
transactions based on the imported information. |
| |
|
| |
CN!Express
cannot distinguish between a credit card, a purchase card, and PIN-less debit
transaction. |
| |
If
you are processing purchase cards or PIN-less debit transactions, you must
import the Tender Type. |
| |
|
| |
The
following table lists the acceptable Tender Types and also shows the data
CN!Express uses for automatic identification. |
| |
Type |
Description |
Distinguishing
Feature |
| |
C |
Credit
Card |
|
| |
K |
Check |
Routing
Number |
| |
B |
Bill
Me Later |
T
and C Version |
| |
D |
PIN
Debit |
PIN |
| |
L |
PINless
Debit |
|
| |
P |
Purchase
Card |
|
| |
Supported
for Chase Paymentech Orbital Gateway only |
| |
|
| |
Terminal
Output Capability |
Additional
Credit Card |
A/N[1] |
| |
TOPCAPB |
0 |
| |
Indicates
whether the terminal is capable of printing or display. |
| |
American
Express only. This is additional information that you can specify to describe
the transaction environment. |
| |
Value |
Description |
|
| |
0 |
Unknown |
|
| |
1 |
None |
|
| |
2 |
Printing |
|
| |
3 |
Display |
|
| |
4 |
Print
and Display |
|
| |
Local
field/ reserved for future use |
| |
|
| |
Total
Payments |
Recurring/Installment |
N[2] |
| |
TOTPMTS |
4 |
| |
The
total number of payments in an installment order. |
| |
Supported
for: PayPal,Transfirst ePay |
| |
|
| |
Track
1 |
Retail |
A/N[76] |
| |
TRACK1 |
TRACK1DATA |
| |
Card
Swipe data from Track 1. |
| |
Card
present retail transactions should provide either Track 1 or Track 2 data,
but not both. |
| |
If a
transaction does contain both Track 1 and Track 2 data, CN!Express defaults
to using the Track 1 data. |
| |
Supported
for Trident Payment Gateway only |
| |
|
| |
Track
2 |
Retail |
A/N[39] |
| |
TRACK2 |
TRACK2DATA |
| |
Card
Swipe data from Track 2. |
| |
Card
present retail transactions should provide either Track 1 or Track 2 data,
but not both. |
| |
If a
transaction does contain both Track 1 and Track 2 data, CN!Express defaults
to using the Track 1 data. |
| |
Supported
for Trident Payment Gateway only |
| |
|
| |
Transaction
Identifier |
Credit
Card Authorization Specifics |
A/N[25] |
| |
TRANSID |
2390239023A9J |
| |
Returned
by Transfirst with the authorization. May be tracked and optionally returned
with the deposit transaction. An identifier, assigned by Visa or Mastercard,
used to uniquely identify and link all related messages and records used to
authorize and settle the transactions. |
| |
Supported
for Transfirst ePay only |
| |
|
| |
Unique
Transaction ID |
Identifiers |
A/N[48] |
| |
UTID |
0123456789abcdefghijklmnopqrstuvwxyz_ABC-DEFGHIJ |
| |
CN!Express
4250 can optionally be configured to generate and store UTIDs for each
successful authorization. CN!Express can later use the UTID to look up the
customer account number for a transaction. The merchant can store the UTID
instead of the account number and send the UTID to CN!Express for later
deposit (and refunds, if required). |
| |
Using
UTIDs relieves the merchant of the requirement to store credit card account
numbers to use in follow-up transactions over the life of an order. |
| |
Local
field/ reserved for future use |
| |
|
| |
Validation
Code |
Credit
Card Authorization Specifics |
A/N[4] |
| |
VALCODE |
1234 |
| |
Returned
by Transfirst with the authorization. May be tracked and optionally returned
with the deposit transaction. Value is assigned by the Visa authorization
system. |
| |
Used
by Visa to determine the accuracy of the authorization data contained in the
settlement record. |
| |
Supported
for Transfirst ePay only |
| |
|
| |
VAT
Amount |
PC
Level 3/Detail Records |
N[12] |
| |
VATAMT |
1 |
| |
Amount
of total transaction that represents European VAT tax. |
| |
Local
field/ reserved for future use |
| |
|
| |
VAT
Rate |
PC
Level 3/Detail Records |
N[4] |
| |
VATRATE |
1.5 |
| |
Local
field/ reserved for future use Rate at which VAT was calculated for this
transaction. |
| |
Local
field/ reserved for future use |
| |
|
|
Visa
Authentication CAVV |
VbV/Secure
Code |
A/N[40] |
| Visa Authentication CAVV |
VICAVV |
CAVV |
| |
Value
returned by Verified by Visa service prior to authorization. Include with
Authorization for Verified by Visa transactions. A cryptographic value that
links the Issuer's authentication or attempted authentication response with a
subsequent authorization message for that purchase. |
| |
Supported
for: Chase Paymentech Orbital Gateway,Transfirst ePay |
| |
|
|
Visa
Authentication CAVV Response |
VbV/Secure
Code |
A/N[1] |
| Visa Authentication CAVV
Respo |
VICAVVRS |
2 |
| |
Result
code returned during Authorization of a Verified by Visa transaction. Will be
one of the following: |
| |
Code |
Description |
|
| |
[Blank] |
CAVV
not present. |
|
| |
0 |
CAVV
not validated due to erroneous data submitted. |
|
| |
1 |
CAVV
failed validation. This is an indication of potential bad or fraudulent data
submitted as the CAVV. |
|
| |
2 |
CAVV
passed validation--Authentication Transaction. |
|
| |
3 |
CAVV
passed validation--Attempted Authentication Transaction. |
|
| |
Determined
that the Issuer ACS generated this value from the use of the Issuer's CAVV
key(s). |
|
| |
4 |
CAVV
failed validation Attempted Authentication Transaction. This is an indication
of potential bad or fraudulent data submitted as the CAVV. |
|
| |
Determined
that Visa generated this value from the use of CAVV key(s). |
|
| |
5 |
Reserved
for future use. |
|
| |
6 |
CAVV
not validated Issuer not participating in CAVV validation. This value is
generated when an Issuer requests the "do not verify" flag to be
established for its BINs. This parameter enables an Issuer to temporarily
stop CVV verification while resolving CAVV key issues. VisaNet processes this
value as a valid CAVV. |
|
| |
7 |
CAVV
failed validation Attempted Authentication Transaction. This is an indication
of potential bad or fraudulent data submitted as the CAVV. CAVV generated
with Visa Key Issuer ACS unavailable. |
|
| |
8 |
CAVV
passed validation Attempted Authentication Transaction. CAVV generated with
Visa Key. |
|
| |
9 |
CAVV
Failed Validation Attempted Authentication Transaction. This is an indication
of potential bad or fraudulent data submitted as the CAVV CAVV generated with
Visa Key Issuer ACS unavailable. |
|
| |
A |
CAVV
passed validation Attempted Authentication Transaction. CAVV generated with
Visa Key Issuer ACS unavailable. |
|
| |
B |
CAVV
passed validation Attempted Authentication Transaction. No liability shift.
Indication that the account number is a commercial card or a prepaid gift
card or that this transaction was an encrypted Internet transaction for which
authentication was not provided--in other words, a typical HTTPS Web
transaction. |
|
| |
C |
CAVV
not validated Attempted Authentication Transaction. Issuer did not return a
CAVV results code in the authorization response. VisaNet will treat this as a
valid CAVV if the Issuer approved the transaction. |
|
| |
D |
CAVV
not validated Authentication. Issuer did not return a CAVV results code in
the authorization response. VisaNet will treat this as valid CAVV if the
Issuer approves the authorization. |
|
| |
I |
Invalid
Security Data. |
|
| |
U |
Issuer
does not participate or 3-D Secure data not utilized. |
|
| |
Supported
for: Chase Paymentech Orbital Gateway,Transfirst ePay |
| |
|
|
Visa
Authentication XID |
VbV/Secure
Code |
A/N[40] |
| Visa Authentication XID |
VIXID |
XID |
| |
Value
returned by Verified by Visa service prior to authorization. Include with
Authorization for Verified by Visa transactions. A unique tracking number set
by the Merchant and sent to the Issuer Authentication Server. |
| |
Supported
for: Chase Paymentech Orbital Gateway,Transfirst ePay |
| |
|
| |
Web
Password |
Other |
A/N[40] |
| |
WEBPASS |
webpass01 |
| |
Used
for transactions presented via the Web interface. This value is used by
CN!Express only, it is not sent to the payment processor. |
| |
Local
field/ reserved for future use |
| |
|
| |
Web
User |
Other |
A/N[40] |
| User |
WEBUSER |
webuser |
| |
Used
for transactions presented via the Web interface. This value is used by
CN!Express only, it is not sent to the payment processor. |
| |
Local
field/ reserved for future use |
| |
|
| |
Class |
Common
Request Fields |
M|E|R|I|ER|EI|P |
| Class |
XCLASS |
E |
| |
Transaction
Class. Must be one of the following: |
| |
Class |
Description |
|
| |
E |
Ecommerce |
|
| |
D |
Merchant
Default |
|
| |
I |
Installment |
|
| |
M |
Mail
Order/ Phone Order: MOTO |
|
| |
R |
Recurring |
|
| |
V |
IVR |
|
| |
P |
Retail
(POS) |
|
| |
Not
all transaction classes are supported by all processors. |
| |
Supported
for: Chase Paymentech Orbital Gateway,Trident Payment Gateway,Transfirst ePay |
| |
|
| |
Transaction
Sequence |
Other |
N[10] |
| |
XSEQ |
1 |
| |
This
field is provided for compatibility with the Trevance transaction gateway,
and is not used by CN!Express. |
| |
Local
field/ reserved for future use |
| Check Fraud |
No equivalent (no
longer supported by Chase Paymentech). |
|
|
| Discount |
No equivalent. (When
level 3 support is complete, this will map to a field called DISC). |
|
|
| VPAS
Authenticated |
No equivalent. Send
VICAVV and VIXID for authenticated VPAS transactions. |
|
|
| |
If you want to
indicate that VPAS authentication was attempted but was not successful, set
ECOMTYP to 6 |
|
|