Developer's Guide

Submitting Purchasing Card Level 2 and Level 3 Transactions
American Express Purchasing Card Transaction Processing
C
148 31 July 2012 Gateway Developer Guide and Reference
MERCHANTCITY (Optional) The name of the city were the transaction took place.
 If you are a third-party biller (bill for services or goods rendered by another
entity), you must enter the name of the city in which the seller is located.
 If you are a mail order, phone order, or internet industry, you may substitute the
name of the city in which the merchant’s order processing facility is located.
Character length and limitations: 21 alphanumeric characters. If more than 21
characters, use proper and meaningful abbreviation. Do not truncate.
MERCHANTSTATE (Optional) The region code that corresponds to the state, province, or country
subdivision of the merchant location where the transaction took place.
Region code examples:
 CA = California, USA
 NS = Nova Scotia, Canada
 COS = Colima Mexico
If you are a third-party biller (bill for services or goods rendered by another entity),
you must enter the region code that corresponds to the state, province, or country
subdivision in which the seller is located.
Character length and limitations: 3 alphanumeric characters
MERCHANTZIP (Optional) The 5- to 9-digit zip (postal) code excluding spaces, dashes, and non-
numeric characters where the transaction took place.
If you are a third-party biller (bill for services or goods rendered by another entity),
you must enter the postal code that corresponds to the seller’s location.
Character length and limitations: 15 alphanumeric characters
MERCHANTCOUNTRYCODE (Optional) Country code of the location where the transaction took place.
Character length and limitations: 3 alphanumeric characters
MERCHANTLOCATIONID (Optional)Merchant-assigned store or location number (or name) that uniquely
identifies where the transaction took place.
Character length and limitations: 15 alphanumeric characters
MERCHANTID (Required) American Express-assigned service establishment number used to identify
and facilitate payments to merchants.
Character length and limitations: 15 alphanumeric characters.
MERCHANTCONTACTINFO (Optional) Merchant’s telephone number or web address. (URLs and e-mail addresses
may be lowercase, as appropriate.) This entry may appear on the descriptive bill on
the card-member’s statement, or may be used to resolve billing inquiries and disputes.
NOTE: American Express strongly recommends that aggregators (third-parties who
bill for goods or services rendered by another entity) always fill in this field
with the URL, e-mail address, or telephone number of the contact responsible
for resolving disputes or inquiries.
Character length and limitations: 40 alphanumeric characters
Field Description