API Fields

 

Table 3

Merchant Descriptor Fields for FDC Nashville Global

Field	Description	Used By: Required (R) or Optional (O)	Data Type & Length
invoiceHeader_merchantDescriptor	Business description. This value must consist of your business name. When payments are made in installments, this value must also include installment information such as “1 of 5” or “3 of 7.” This value is displayed on the cardholder’s statement. For information about what happens when you do not include this value in your request, see Merchant Descriptor Logic.	ccAuthService (O) ccCaptureService (O) ccCreditService (O) When you include this field in a request, you must also include invoiceHeader_merchantDescriptor Contact and invoiceHeader_merchantDescriptor State.	String (22)
invoiceHeader_merchantDescriptor Alternate	Alternate contact information for your business, such as an email address or URL. This value might be displayed on the cardholder’s statement. For information about what happens when you do not include this value in your request, see Merchant Descriptor Logic. For authorizations, CyberSource does not provide this value to the processor. Instead, CyberSource stores this value and sends it to the processor for captures and follow-on credits.	ccAuthService (O) ccCaptureService (O) ccCreditService (O)	String (13)
invoiceHeader_merchantDescriptor Contact	Contact information for your business. For a card-present request, this value must be the city in which your store or outlet is located. For a card-not-present request, this value must be your customer service telephone number. When you include more than one consecutive space, extra spaces are removed. This value might be displayed on the cardholder’s statement. For information about what happens when you do not include this value in your request, see Merchant Descriptor Logic.	ccAuthService (O) ccCaptureService (O) ccCreditService (O) When you include this field in a request, you must also include invoiceHeader_merchantDescriptor and invoiceHeader_merchantDescriptor State.	String (11)
invoiceHeader_merchantDescriptor Country	Country in which your business is located. Use the two-character ISO Standard Country Codes. This value might be displayed on the cardholder’s statement. For information about what happens when you do not include this value in your request, see Merchant Descriptor Logic.	ccAuthService (O) ccCaptureService (O) ccCreditService (O)	String (2)
invoiceHeader_merchantDescriptor PostalCode	Postal code for your business location. This value might be displayed on the cardholder’s statement. When the merchant descriptor country is the U.S., the postal code must consist of five digits or nine digits. A 9-digit postal code must follow this format: [5 digits][dash][4 digits] Example 12345-6789 When the merchant descriptor country is Canada, the 6-digit postal code must follow this format: [alpha][numeric][alpha][space] [numeric][alpha][numeric] Example A1B 2C3 For information about what happens when you do not include this value in your request, see Merchant Descriptor Logic.	ccAuthService (O) ccCaptureService (O) ccCreditService (O)	String (10)
invoiceHeader_merchantDescriptor State	State or territory in which your business is located. cardholder’s statement. When the merchant descriptor country is the U.S. or Canada, use the State, Province, and Territory Codes for the United States and Canada. This value might be displayed on the cardholder’s statement. For information about what happens when you do not include this value in your request, see Merchant Descriptor Logic.	ccAuthService (O) ccCaptureService (O) ccCreditService (O) When you include this field in a request, you must also include invoiceHeader_merchantDescriptor and invoiceHeader_merchantDescriptor Contact.	String (20)
invoiceHeader_merchantDescriptor Street	Street address for your business location. When you include this value in your request, CyberSource recommends the following: ■ If you are located in the United States or Canada, also include the merchant descriptor country, merchant descriptor state, and merchant descriptor postal code in your request. ■ If you are not located in the United States or Canada, also include the merchant descriptor country and merchant descriptor postal code in your request. This value might be displayed on the cardholder’s statement. For information about what happens when you do not include this value in your request, see Merchant Descriptor Logic.	ccAuthService (O) ccCaptureService (O) ccCreditService (O) FDC Nashville Global recommends that you include this value for debit card requests and for American Express credit card requests.	String (60)