Custom Fields (Advanced Data Collection)

Purpose:

Custom Fields let you collect and track any data point beyond standard transaction fields.

Location:

Navigate to Control Panel > Custom Fields

Creation Process:

  1. Click “Add Custom Field” or “+ New”
  2. Enter Label: What the field is called
    • Examples: “Department Code”, “Project Number”, “Vehicle VIN”, “Policy Number”, “Event Name”
  3. Select Field Type:
    • Text: Free-form text entry
    • Number: Numeric only
    • Dropdown: Pre-defined list of options
    • Checkbox: Yes/no toggle
    • Date: Date picker
  4. Set as Required (Optional):
    • Click star icon until it turns purple
    • Field becomes mandatory for transaction processing
  5. Add Default Value (Optional):
    • Pre-populate field with common value
  6. Click Save

Custom Field Limit:

  • Most gateways support up to 20 custom fields
  • Plan carefully which data points are most important

Where Custom Fields Appear:

Once created, custom fields automatically appear in:

  • Process Transaction Tab: Under “Custom Fields” banner
  • Hosted Payment Pages: Can drag custom field block onto page
  • Invoices: Can include custom fields (if enabled in invoice settings)
  • Reports: Appears as column in transaction reports
  • Receipts: Can show on receipts (if enabled in Custom Receipts)

Custom Field Use Cases:

By Industry:

Healthcare:

  • Patient ID
  • Insurance Policy Number
  • Referring Doctor
  • Service Code

Property Management:

  • Unit Number
  • Lease ID
  • Property Name
  • Tenant Name

Event Ticketing:

  • Event Name
  • Ticket Tier (VIP, General, etc.)
  • Date of Event
  • Seat Number

Auto Services:

  • Vehicle VIN
  • License Plate
  • Service Advisor
  • Mileage

Contractors:

  • Job Number
  • Project Name
  • Project Manager
  • Work Order ID

Nonprofits:

  • Donation Campaign
  • Donor ID
  • Dedication (In Memory Of, In Honor Of)
  • Tax-Deductible Amount

Managing Custom Fields:

Edit Custom Field:

  • Click edit icon
  • Can change label, type, required status
  • Warning: Changing type (text to number) may break existing data

Reorder Fields:

  • Click and drag to reorder
  • Order determines display order in transaction screen

Delete Custom Field:

  • Click delete icon
  • Warning: Field is removed from all future transactions
  • Historical data remains but field disappears from display

Best Practices:

  • Use clear, descriptive labels
  • Make critical fields required (prevents forgetting)
  • Don’t create too many (overwhelming for users)
  • Consider which fields employees actually need vs. nice-to-have
  • Train employees on what to enter in each field