Configuring the Virtual Terminal
The Virtual Terminal is a Web-based version of the credit card terminals that you use at a retail store. Use the Virtual Terminal to process a purchase by telephone, fax, or email, or at the point of sale, such as in your store.
The Virtual Terminal settings, located under the Virtual Terminal tab, determine the information that you will enter to process each new transaction.
This section describes the Virtual Terminal fields that you can configure. The figures show the many sections of the settings page. The online help in the Business Center explains how to configure the settings.
General Settings
Settings View
Views that are available for the Virtual Terminal: if these options are available to you, you can view the settings for either card-not-present or retail (card-present) transactions. You can display or require totally different elements for each view.
Default Type of Transaction
Default type of Virtual Terminal that appears if these options are available to you. You need to select how you want to process your card transactions. Your may accept transactions in one of two ways:
■
Card-present transactions: the customer and the card are both present in your store (retail transactions).
■
Card-not-present transactions: neither the customer nor the card are present in your store (MOTO or Internet transactions).
Your account provider may support retail card-present transactions, which apply to all credit cards and to debit cards that have the Visa or MasterCard logo. For more information, please contact your account provider or Customer Support.
For either type of transaction, your options are to process an authorization or a sale. However, remember that an authorization does not move money into your bank account. After you ship the customer’s order, you must capture the authorization. Card associations require you to ship the customer’s order or perform the service before you request a capture.
The following table shows the available settings in the first two columns and the corresponding results in the New Transaction page. In every case, the default Transaction Source is MOTO - Mail/Phone Order before the card is scanned and Retail after the card is scanned or after the card information is entered in the order form.
Payment Information
Credit Card
Types of credit cards that your merchant bank account supports. The default card types are Visa and MasterCard. The selections that you make in the Virtual Terminal apply also to the Hosted Order Page settings.
Card Verification Number
Three- or four-digit number printed on the back or front of credit cards. This number ensures that your customer has physical possession of the card at the time of the order. For more information on the card verification number, see
Card Verification Number
.
For each card type that you select in the first column, you can also select to display (second column) or require (third column) the card verification number. The field appears in the order form below the credit card number in bold if you choose to require it or in normal type if you choose to only display it.
When the customer selects a credit card type in the order form, the CVN field appears below the credit card field.
Fields that appear in the order form
Credit card type
Credit card number
Card verification number (optional) Expiration date
Check
To display the check fields in the Virtual Terminal and offer checks as a payment option, check this box. These fields always appear in the order form:
Account number
Routing number
Account type
Check number
Driver's license number and state
Date of birth
The fields that are displayed on the order form vary according to the payment processor that your account provider uses. Required fields are displayed in bold type whereas optional fields are in normal type. The account types available are checking, savings, or corporate checking.
Customer Information
For this and the next sections, you have many choices for using these fields:
■
If you display the fields on the order form, the fields will be optional for the user to complete.
■
If you require the fields on the order form, the fields will appear orange, and the user will not be able to submit the order unless these fields are completed.
■
If you add the fields to the receipt, the fields’ content will appear on the customer’s receipt or packing slip.
Customer ID
Optional customer’s account ID, tracking number, reward number or other unique number that you can assign to the customer. This ID will appear on the settlement page where you can modify the value if necessary.
Company
Name of the customer’s company.
Phone Number
Customer’s phone number.
Email Address
Customer’s email address.
Order Information
The behavior and requirements that apply to the customer information fields in the previous section also apply to these fields.
Order Number
Unique merchant reference number that you create for the order.
Comment
Brief description of the order or any comment you wish to add to the order. Comments will appear on the settlement page where you can modify the content if necessary.
Shipping Address
Whether to display the shipping address fields. These fields appear in the Customer Information section of the order form.
Merchant-Defined Data Fields
The behavior and requirements that apply to the customer information fields in the previous section also apply to these fields. These fields appear in the Order Information section of the order form.
You can use these four fields to add non-sensitive comments or additional information to the order. The content of the field appears in the Virtual Terminal, the transaction confirmation and receipt, the transaction search detail page (even after you capture or void the transaction), the exportable search results, and the Order Detail report. You can use these fields with all the credit card and check transactions available in the Virtual Terminal. When using the merchant-defined data fields, you must follow these rules:
Merchant-Defined Data fields are not intended to and MUST NOT be used to capture personally identifying information. Accordingly, Merchant is prohibited from capturing, obtaining, and/or transmitting any personally identifying information in or via the Merchant-Defined Data fields. Personally identifying information includes, but is not limited to, credit card number, social security number, driver's license number, state-issued identification number, passport number, and card verification numbers (CVV, CVC2, CVV2, CID, CVN). In the event CyberSource discovers that Merchant is capturing and/or transmitting personally identifying information via the Merchant-Defined Data fields, whether or not intentionally, CyberSource WILL immediately suspend Merchant's account, which will result in a rejection of any and all transaction requests submitted by Merchant after the point of suspension.
Unless you specify in the settings page a name for the field(s) that you display, require, and/or add to the receipt, the field(s) will appear labeled as Merchant-Defined Data Field X on the order form. You can choose any name that you want, such as shipping method. If you enter a default value, this value will appear on the order form as an editable field.
Level II and Additional Level III Fields
Level II Fields
Level II cards, which are also known as Type II cards, provide consumers with additional information on their credit card statements about their purchases. Level II cards enable consumers to more easily track the amount of sales tax they pay and to reconcile transactions with a unique customer code. Level II cards are separated into two categories:
■
Business/Corporate Cards—Given by businesses to employees for business-related expenses such as travel and entertainment or for corporate supplies and services.
■
Purchase/Procurement Cards—Used by businesses for expenses such as supplies and services. These cards are often used as replacements for purchase orders.
Each processor supports a different set of Level II fields. If your business is not in the United States, you must use additional fields.
The behavior and requirements that apply to the customer information fields in the previous section also apply to these fields. For more information on these fields, see
Level II and Level III Processing Using the Simple Order API
and
Level II and Level III Processing Using the SCMP API
.
Level II Duty
Amount charged on imported and exported items.
Level II Purchase Order Number
Purchase order number or customer reference ID that is provided by the customer. Note that this number is different from the Customer ID mentioned above in the Customer Billing Information section.
Level II Tax
Amount of tax in the order.
Level II Tax Exempt
Tax exemption status of the order.
Level III and Additional Level II Fields
Purchasing cards are special credit cards that employees use to make purchases for their company. You provide additional detailed information—the Level III data—about the purchasing card order during the settlement process. The Level III data is forwarded to the company that made the purchase and allows the company to manage its purchasing activities.
When you select the line-item fields in the Virtual Terminal settings page, the fields appear in the Virtual Terminal, the transaction receipt, and the details page for the transaction.
Each processor supports a different set of Level II and Level III fields. If you submit a Level II or Level III transaction but omit required fields, your processor could charge you penalties or increase your fees. For descriptions of the fields and to find out if you can or should use these fields for your processor, see
Level II and Level III Processing Using the Simple Order API
and
Level II and Level III Processing Using the SCMP API
.
Below is an example of the Virtual Terminal Settings page.
You can choose to Hide, Read Only, Optional, or Require each Order-Level and Item-Level field.
■
If you choose to Hide a field, you can still pass in the field, but it will be hidden from the customer.
■
If you choose to make a field Read Only, the field will display with the value you selected. The customer cannot change it.
■
If you choose to make the field Optional, the customer can fill in the field or leave it blank.
■
If you choose to make a field Required, the customer is required to fill in the field.
Select your choice from the Field Settings menu. Click the Reciept checkbox to have the fields display on the customer's emailed reciept and your emailed reciept.
The table below shows the corresponding Business Center, Simple Order API, and SCMP API field names for the Level II and Level III fields in the Business Center.
Table 1
Level III and Additional Level II Order-Level Fields
Business Center
Field Name
Simple Order API
Field Name
SCMP API
Field Name
Alternate Tax Amount
otherTax_alternateTaxAmount
alternate_tax_amount
Alternate Tax Indicator
otherTax_alternateTaxIndicator
alternate_tax_amount_indicator
Alternate Tax ID
otherTax_alternateTaxID
alternate_tax_id
Transaction Advice Addendum 1-4
invoiceHeader_amexDataTAA1
invoiceHeader_amexDataTAA2
invoiceHeader_amexDataTAA3
invoiceHeader_amexDataTAA4
amexdata_taa1
amexdata_taa2
amexdata_taa3
amexdata_taa4
Duty Amount
purchaseTotals_dutyAmount
duty_amount
Freight Amount
purchaseTotals_freightAmount
freight_amount
Purchase Order Number
invoiceHeader_userPO
user_po
Local Tax
otherTax_localTaxAmount
local_tax
Local Tax Indicator
otherTax_localTaxIndicator
local_tax_indicator
Merchant VAT Registration Number
invoiceHeader_merchantVAT
RegistrationNumber
merchant_vat_registration_number
National Tax
otherTax_nationalTaxAmount
national_tax
National Tax Indicator
otherTax_nationalTaxIndicator
national_tax_indicator
Order Discount Amount
purchaseTotals_discountAmount
order_discount_amount
Purchaser Code
invoiceHeader_purchaserCode
purchaser_code
Purchaser Order Date
invoiceHeader_purchaseOrderDate
purchaser_order_date
Purchaser VAT Registration Number
invoiceHeader_purchaserVATRegistration
Number
purchaser_vat_registration_number
Ship From Postal/Zip Code
shipFrom_postalCode
ship_from_zip
Summary Commodity Code
invoiceHeader_summaryCommodityCode
summary_commodity_code
Supplier Order Reference Number
invoiceHeader_supplierOrderReference
supplier_order_reference
Taxable
invoiceHeader_taxable
tax_indicator
VAT Invoice Reference Number
invoiceHeader_vatInvoice
ReferenceNumber
vat_invoice_ref_number
VAT Tax Amount
otherTax_vatTaxAmount
vat_tax_amount
VAT Tax Rate
otherTax_vatTaxRate
vat_tax_rate
Table 2
Level III and Additional Level II Item-Level and Offer-Level Fields
CyberSource
Field Name
Simple Order API
Field Name
(Item-Level)
SCMP API
Field Name
(Offer-Level)
Alternate Tax Amount
item_#_alternateTaxAmount
alternate_tax_amount
Alternate Tax ID
item_#_alternateTaxID
alternate_tax_id
Alternate Tax Rate
item_#_alternateTaxRate
alternate_tax_rate
Alternate Tax Type Applied
item_#_alternateTaxTypeApplied
alternate_tax_type_applied
Alternate Tax Type
item_#_alternate_TaxType
alternate_tax_type_identifier
Unit Price
item_#_unitPrice
amount
Commodity Code
item_#_commodityCode
commodity_code
Discount Amount
item_#_discountAmount
discount_amount
Discount Indicator
item_#_discountIndicator
discount_indicator
Discount Rate
item_#_discountRate
discount_rate
Gross Net Indicator
item_#_grossNetIndicator
gross_net_indicator
Local Tax
item_#_localTax
local_tax
Product SKU
item_#_productSKU
merchant_productsku
National Tax
item_#_nationalTax
national_tax
Product Code
item_#_productCode
product_code
Product Name
item_#_productName
product_name
Quantity
item_#_quantity
quantity
Tax Amount
item_#_taxAmount
tax_amount
Tax Rate
item_#_taxRate
tax_rate
Tax Type Applied
item_#_taxTypeApplied
tax_type_applied
Total Amount
item_#_totalAmount
total_amount
Unit of Measure
item_#_unitOfMeasure
unit_of_measure
VAT Rate
item_#_vatRate
vat_rate
Invoice Number
item_#_invoiceNumber
invoice_number
Result Fields
In addition to order fields, you can add two of the results fields to the receipt. These results, which are returned only for payment card transactions, can help you in reconciling your transactions or in keeping track of statistics.
AVS result
This field provides the abbreviated definition of the address verification result for the transaction. This result is returned by the Address Verification Service of Smart Authorization, which is discussed on
Address Verification Service (AVS)
.
Authorization code
This field provides the 6-digit authorization code that you receive for card transactions.
Default Values
Country
Default country where you process transactions.
Currency
Default currency that you accept.
Transaction Type
Default type of transaction that you process: authorization or sale (authorization and capture).
Email Receipt
You use these settings to indicate whether you want to send an email receipt to the customer and the email address that is to appear in the sender’s field of the receipt.
Printable Receipt
This section is divided into two parts:
■
Indicate the phone number and email address that you want to appear on the printed receipt for your business.
■
Use printed receipts for retail transactions and as packing information for the orders that you ship. You can select either a single or a double receipt. You can use part of the double receipt format to give to your customer at the point of sale or as packing slip when you ship goods. This figure shows a sample single receipt with all the possible fields. For a sample double receipt, see the printed receipt on
printed receipt
.