Virtual Terminal Field Reference

The Virtual Terminal includes a variety of fields that may appear depending on your merchant configuration and enabled options. This reference explains each field, its purpose, and when it typically appears.

Legend

  • Card – Field appears only when Card is selected
  • Check – Field appears only when Check/ACH is selected
  • Both – Field appears for either payment type

1. Customer & Transaction Settings

The** Customer & Transaction Settings** fields determine the type of transaction being processed and allow selection of an existing customer profile.

Field NameDescriptionApplies To
CustomerSelect or add a customer record to associate with a payment.Both
Transaction TypeDefines the action (Sale, Authorization, Repeat Sale, Force Capture, Refund).Both

2. Payment Fields

The Payment Fields section lists every field that can appear in the Virtual Terminal, organized by payment type. These fields determine the information required to process a transaction using either a card or a check/ACH account. Use the tabs below to view the fields that apply to each payment method.

These fields appear when Card is selected as the payment method.


Card Information

Field NameDescriptionApplies To
Card NumberCardholder’s primary account number.Card
CVCThree- or four-digit card security code.Card
Expiration DateCard expiration in MM/YY format.Card
Name on CardCardholder's full name.Card

Billing Address (Card)

Field NameDescriptionApplies To
Address 1Primary billing address line.Card
Address 2Secondary billing address line.Card
Billing CityCity for billing address.Card
Billing EmailCustomer email address.Card
Billing PhoneCustomer phone number.Card
Billing StateState or province.Card
Billing ZipBilling postal/ZIP code.Card

Shipping Address (Card)

Field NameDescriptionApplies To
Same as BillingCopies billing details into shipping fields.Card
Shipping Address 1Primary shipping address line.Card
Shipping Address 2Secondary shipping address line.Card
Shipping CityShipping city.Card
Shipping StateShipping state/province.Card
Shipping ZipShipping postal/ZIP code.Card
CountryDestination country (default: USA).Card
ProvinceAdditional region/province (if applicable).Card

Level 2 Data (Card)

Field NameDescriptionApplies To
Merchant ZipMerchant ZIP code for Level 2 data.Card
PO NumberPurchase order number.Card
Transaction DateOriginal transaction date.Card

Level 3 Data (Card)

Field NameDescriptionApplies To
Destination ZipDestination ZIP code for shipped goods.Card
Invoice NumberInvoice reference for the transaction.Card
Order NumberCustomer order identifier.Card
Ship From ZipShip-from ZIP code.Card

3. Transaction Summary

The Transaction Summary section includes the primary financial fields used to calculate the total transaction amount.

Field NameDescriptionApplies To
Base AmountCore transaction amount before tax, tip, or fees.Both
TipOptional gratuity amount.Both
TaxTax associated with the transaction.Both
Tax ExemptMarks the transaction as exempt from tax.Both
ShippingShipping charges included in the transaction.Both
Convenience FeeAdditional fee applied if enabled for the merchant.Both
EstimatedMarks the total as estimated rather than final.Both
TotalFinal calculated transaction amount.Both