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