All API variables broken into parts.

x_test_request

NO

Value: TRUE, FALSE, YES, NO,

If YES/TRUE, requests made will not be settled

x_login

X

Value: The merchant’s unique Login ID
Format: Up to 20 character
Provided by the NaviGate gateway.

The Login ID and Transaction Key together are required to be able to send requests to the gateway API.

x_tran_key

X

Value: The merchant’s unique Transaction Key
Format: 16 character

This key is generated by NaviGate in Profile & Settings » Security » Transaction Key

x_version

X

Value: 3.1 (constant/static)

Not required but is considered good practice and the system prefers to see it

x_delim_data

X

Value: TRUE/FALSE

Based on the value (TRUE/FALSE) the response is going to be either delimited or not.

x_delim_char

X

Value: any character that is normally used for delimiting data

Possible variants: comma (,); semicolon (;); pipe (|); etc

x_relay_response

X

Value: FALSE (constant/static) 

Not required but is considered good practice and the system prefers to see it

x_Method

Value: The Method of credit card transaction
Format: CC; (SVP – not fully functional » ?) 

If this field is not submitted or the value is blank, the payment gateway will generate an error "x_Method cannot be left blank".

x_type

Type

Definition

AUTH_CAPTURE

Authorize and Capture – reserves and amount and charges the account.

AUTH_ONLY

Authorization – reserves an amount but does not charge. Charging an account occurs later

CREDIT

Issue a credit – refund amount previously charged

PRIOR_AUTH_CAPTURE

Capture – charges an account that was previously Authorized

VOID

Voids transaction – Cancels Auth & Capture and Authorization

If the value submitted does not match a supported value, the transaction is rejected. If this field is not submitted or the value is blank, the payment gateway will generate an error "x_type cannot be left blank".

x_amount

Value: The amount of the transaction
Format: Up to 15 digits (no dollar symbol or cents separators).

For example, “1020” would mean $10.20 and “110” would mean $1.10

This is the total amount and must include tax, shipping, and any other charges. If this field is not submitted or the value is blank, the payment gateway will generate an error "x_amount cannot be left blank".

x_card_num

Value: The customer’s credit card number
Format: Between 13 and 16 digits without spaces. 

This is sensitive cardholder information and must be stored securely and in accordance with the Payment Card Industry (PCI) Data Security Standard. If this field is not submitted or the value is blank, the payment gateway will generate an error "x_card_num cannot be left blank".

x_card_code

Value: The customer’s credit card security code.
Format: 3 or 4 digit code depending on the issuer 

The security code is located on the card in different places, depending on the issuer.

Take a look at the image below which shows usual locations for the code. 

x_exp_date

Value: The customer’s credit card expiration date.
Format: MMYY 

This is sensitive cardholder information and must be stored securely and in accordance with the Payment Card Industry (PCI) Data Security Standard. If this field is not submitted or the value is blank, the payment gateway will generate an error "x_exp_date cannot be left blank".

x_trans_id

Value: The payment gateway-assigned ID that links the current authorization request to the original authorization request.
Format: Numeric 

This value applies only to partial authorization transactions, and is returned in the reply message from the original authorization request. If this field is not submitted or the value is blank, the payment gateway will generate an error "x_trans_id cannot be left blank".

x_invoice_num

No

Value: This is a merchant supplied number that they want to be able to track the sales by in NaviGate.
Format: string (any characters)

x_description

No

Value: This is a merchant supplied description of the sale that was made.
Format: string (any characters)

Field Name

Required

Description

x_first_name

Value: Self-explanatory.
Format: string

x_last_name

Value: Self-explanatory.
Format: string

x_company

Value: Self-explanatory.
Format: string

x_address

Value: Self-explanatory.
Format: string

x_city

Value: Self-explanatory.
Format: string

x_state

Value: Self-explanatory.
Format: string

Example: NY (New York)

x_zip

Value: Self-explanatory.
Format: string

x_country

No

Value: Self-explanatory.

Format: string

Example: USA (United State of America)

x_phone

No

Value: Self-explanatory.
Format: numeric (no dashes)

x_fax

No

Value: This is a merchant supplied description of the sale that was made.
Format: numeric (no dashes)

x_Email

Value: Self-explanatory.
Format: string

x_cust_id

No

Value: Customer ID, provided by the merchant.
Format: string

Example: This ID is supplied by the merchant at the time of sale to track individual customers purchasing patterns.

x_customer_ip

Value: This is the IP address of the location where the transaction came from.
Format: string

Optional

Value: The first name associated with the customer’s shipping address

Format: Up to 50 characters (no symbols)

Optional

Value: The last name associated with the customer’s shipping address

Format: Up to 50 characters (no symbols)

Optional

Value: The company associated with the customer’s shipping address

Format: Up to 50 characters (no symbols)

Optional

Value: The customer’s shipping address

Format: Up to 60 characters (no symbols)

Optional

Value: The city of the customer’s shipping address

Format: Up to 40 characters (no symbols)

Optional

Value: The state of the customer’s shipping address

Format: Up to 40 characters (no symbols) or a valid two-character state code

Optional

Value: The ZIP code of the customer’s shipping address

Format: Up to 20 characters (no symbols)

Optional

Value: The country of the customer’s shipping address

Format: Up to 60 characters (no symbols)

x_tax

This optional field can contain either the valid tax amount or the delimited tax information. When submitting delimited tax information, values must be delimited by a bracketed pipe <|> in the order shown below. The total amount of the transaction in x_amount must include this amount.

The delimited tax information elements are:

• tax item name<|>
• tax description<|>
• tax amount: The dollar sign ($) is not allowed when submitting delimited information.

The total amount of the transaction in x_amount must include this amount.

Example: x_tax=Tax1<|>state tax<|>0.09&

Format: string

x_tax_exempt

This optional field can contain the tax exempt status of the order.
The values of this field can include: TRUE, FALSE, T, F, YES, NO, Y, N, 1, 0

Format: string

x_email_customer

Value: TRUE/FALSE
If True, then the customer will receive an email notifying them about the transaction.

Format: BOOL

x_email_merchant

Value: TRUE/FALSE
If True, then the merchant will receive an email notifying them about the transaction.

Format: BOOL

x_merchant_email

Value: email address
This is the email address that the merchant uses to receive notifications about transaction update to.

Example: newsale@somedomain.com

Format: string

x_recurring_billing

Value: YES/NO

If Yes, then the customer will be charged automatically for the same amount as is set in x_amount.

How often the person is charged is defined in x_recurring_frequencyType.
The number of iteration is set in x_recurring_frequency

Format: BOOL

x_recurring_frequencyType

Value: Daily, Weekly, Monthly, etc

This variable defines the frequency or period on the basis of which the person gets charged.

Format: string

x_recurring_frequency

Value:

This variable sets the max amount of iterations (or number of periods)

Example: If the one period is a week and the number of periods is 15, then the person will be charged for 15 weeks on a weekly basis and then the recurring charges will stop.

Format: numeric

x_Token_Flag

Value: YES/NO

Format: BOOL