SecureNet Gateway Implementation Guide 4.1.5
8 TRANSACTION REQUEST MESSAGE FORMAT
All Gateway transactions include a common set of required parameters (listed first). Additional parameters are required depending on the transaction type. Many optional parameters can also be provided depending on the results that are to be returned.
8.1 Format for Credit Card, Debit Card, EBT, and Stored Value Card Transactions
XML Tag
<TRANSACTION>
Data Type /
Max Length
Object / 1 True
Required Sample Values Reference
<AMOUNT>
<
<CODE>
<METHOD>
< CARD >
<OrderID>
<DCI>
<TEST>
<
MERCHANT_KEY
REF_TRANSID >
>
<TRANSACTION_SER
VICE>
Decimal / 15
Object / 1
String / 4
String / 7
Object / 1
String / 25
Integer / 1
String / 5
Integer / 1
String / 15
True
True
True
True
True
True
True
True
True
Required for
Transaction Code
Total amount to be charged or credited.
Include decimal point followed by decimal amount
Gateway Services
SECURENET ID
SECUREKEY
Refer to
MERCHANT_KEY object for additional values
Refer to the Transaction
Type Table for additional values
0000—AUTH_ONLY
0100—AUTH_CAPTURE
0200—PRIOR_AUTH_CAPTURE
0201—UPDATE_TRANS_INFO
0300—CAPTURE_ONLY
0400—VOID
0401—PARTIAL_VOID
0402—VOID_BY_OrderID
0500—CREDIT
0600—FORCE_CREDIT
0700—VERIFICATION
CC, DB, SV, EBT
Unique Transaction Order ID.
Alphanumeric (Valid values String A-Z, 0-
9)
0, 1, 2, 3
Refer to METHOD for additional values
Refer to the Card Object
Refer to OrderID in
Appendix A
Refer to DCI in Appendix
A
This is case sensitive values
TRUE = Test Transaction
FALSE = Live Transaction
Default is FALSE
Indicates Transaction Handling when
Vault is enabled. Values are 0,1,2,3 – default is 0.
Transaction ID of a previously approved transaction, used in Transaction Code
0400—VOID
0401—PARTIAL_VOID
0500—CREDIT
0200—PRIOR_AUTH_CAPTURE
Refer to
TRANSACTION_SERVIC
E in Appendix A
Refer to REF_TRANSID in
Appendix A for more details
Transaction id value should be a number
45
SecureNet Gateway Implementation Guide 4.1.5
XML Tag
<INDUSTRYSPECIFIC
DATA>
<INSTALLMENT_SEQ
UENCENUM>
<TOTAL_INSTALLMEN
TCOUNT>
<AUTHCODE>
<CUSTOMERID>
<PAYMENTID>
< AUTO >
< PETROLEUM >
Data Type /
Max Length
String / 1
Integer / 2
Integer / 2
String / 6
String / 25
String / 25
Object / 1
Object / 1
Required Sample Values
Required for eCommerce and
MOTO transactions
Leave blank for
Retail transactions
Required if
INDUSTRYSPECIF
ICDATA=3
Required if
INDUSTRYSPECIF
ICDATA = 3
Required for 300 transactions
Industry Specific Data—Required to send the right indicator for transaction.
Accepted values:
P and D - eCommerce
1, 2, and 3 - MOTO
Installment number for installment payment plan 1 – 99
Number of total installments for installment plans 1 – 99
Required for Vault transactions
Required for Vault transactions
Specific to Industry
Specific to Industry
Valid authorization code for Offline
Transaction 0300—CAPTURE_ONLY
Voice Authorization Code
Valid authorization code for EBT Voucher transaction 0300—CAPTURE_ONLY
Contains the customer ID associated with the Authorization Code for EBT Voucher transaction
Must be enabled on the account
SecureNet Vault Payment ID
Must be enabled on the account
Reference
Refer to
INDUSTRYSPECIFICDAT
A in Appendix A for more information.
No space and special character
No space and special character
Refer to the AUTO Object.
Refer to the PETROLEUM
Object.
< HOTEL >
< SERVICE >
<CUSTOMERIP>
Object / 1
Object / 1
String / 15 False
<DEVICECODE>
<ENTRYSOURCE>
<INVOICEDESC>
<INVOICENUM>
String / 2
String / 10
String / 50
String / 50
False
False
False
Required for
Ceridian
The Customer IP address includes the
Customers IP that needs to be associated with the transaction
Recommended for ecommerce merchants
Valid IP of customer
Code for payment device
Blank, unless specified/ provided by
SecureNet
Transaction Source
Blank, unless specified/provided by
SecureNet
Description of the transaction for which invoice is being issued
Invoice number associated with the transaction
46
SecureNet Gateway Implementation Guide 4.1.5
XML Tag
<MARKETSPECIFICDA
TA>
Data Type /
Max Length
String / 2
Required
False
<NOTE> String / 500 False
<OVERRIDE_FROM> Integer / 1 False
<RETAIL_LANENUM> String / 6
<SOFTDESCRIPTOR> String / 25
False
False
< CUSTOMER_BILL > Object / 1
< CUSTOMER_SHIP > Object / 1
< ENCRYPTION >
< LEVEL2 >
< LEVEL3 >
Object / 1
Object / 1
Object / 1
False
False
False
False
False
Sample Values Reference
For bill payment transactions, applicable for Visa only
B—Bill payment
D—Debt indicator (contact SecureNet for more info)
Don't include if a value isn’t sent
For Nashville processor all VISA
Recurring and VISA Installment transactions are considered as Bill
Payment transactions by default
VISA Single Bill payment MOTO transactions are also considered as Bill
Payment
Additional Transaction Notes
Transaction information, billing information and UDF data will come from the listed sources based on the value of this flag:
0 - Transaction Request
1 - Customer Vault Object
2 - Account Vault Object
3 - 0200—PRIOR_AUTH_CAPTURE transaction request, Level 2 information will be overwritten with the new Level 2 values. This should also be used for
0200—PRIOR_AUTH_CAPTURE and
SecureNet Vault transactions.
4 – Customer Vault Billing Information and
Transaction UDF
5 – Account Vault Billing Information and
Transaction UDF
6 - Transaction Billing Information
Customer Vault UDF
7 - Transaction Billing Information and
AccountVault UDF
8 – Account Vault Billing Information and
Customer Vault UDF
9 – Customer Vault Billing Information and
Account Vault UDF
Lane Number for Retail stores
Additional DBA descriptor Refer to
SOFTDESCRIPTOR in the Appendix.
Refer to
CUSTOMER_BILL Object.
Refer to
CUSTOMER_SHIP Object
Refer to ENCRYPTION
Object
47
