
Gateway Developer Guide and Reference 07 February 2013 61
Submitting Credit Card Transactions
Core Credit Card Parameters
6
SWIPE (Required for card-present transactions only) Used to pass the Track 1 or Track 2
data (card’s magnetic stripe information) for card-present transactions. Include either
Track 1 or Track 2 data—not both. If Track 1 is physically damaged, the point-of-sale
(POS) application can send Track 2 data instead.
The track data includes the disallowed = (equal sign) character. To enable you to use
the data, the SWIPE parameter must include a length tag specifying the number of
characters in the track data. For this reason, in addition to passing the track data, the
POS application must count the characters in the track data and pass that number.
Length tags are described in “Using Special Characters In Values” on page 51.
NOTE: SWIPE (card-present transactions) are not supported by the PayPal processor.
Limitations: Alphanumeric and special characters
ORDERID (Optional) Checks for a duplicate order. If you pass ORDERID in a request and pass it
again in the future, the response returns DUPLICATE=2 along with the ORDERID.
NOTE: Do not use ORDERID to catch duplicate orders processed within seconds of
each other. Use ORDERID with Request ID to prevent duplicates as a result of
processing or communication errors.
Character length and limitations: alphanumeric characters
BILLTOFIRSTNAME (Optional) Account holder's first name.
Limitations: 30 alphanumeric characters
BILLTOLASTNAME (Optional but recommended) Account holder's last name.
Limitations: 30 alphanumeric characters
BILLTOSTREET (Optional) The cardholder’s street address (number and street name).
The address verification service verifies the STREET address.
Limitations: 150 alphanumeric characters
BILLTOCITY (Optional) Bill-to city.
Limitations: 45-character string.
BILLTOSTATE (Optional) Bill-to state.
Limitations: 2-character string (Varies depending on processor: 2 to 45 characters).
BILLTOZIP (Optional) Account holder’s 5- to 9-digit zip (postal) code.
Limitations: 9 characters maximum. Do not use spaces, dashes, or non-numeric
characters
BILLTOCOUNTRY (Optional) Bill-to country.
Limitations: 3-character country code.
SHIPTOFIRSTNAME (Optional) Ship-to first name.
Limitations: 30-character string.
SHIPTOLASTNAME (Optional) Ship-to last name.
Limitations: 30-character string.
Parameter Description
Komentarze do niniejszej Instrukcji