The Button Concept in the Click & Pay Suite is a dynamic and customizable feature designed to streamline the item listing and transaction process—particularly from the Contact Details Page and Virtual Terminal (VT). It allows admins to predefine how items are displayed and interacted with by leveraging Salesforce reports or custom data files.
This guide walks you through the creation, configuration, and deployment of buttons within the suite.
🛠️ Creating a Button in Click & Pay Suite
1. Navigate to Button Settings
Go to:
Click & Pay Suite → Launcher (top right corner) → Settings → Buttons
2. Create a New Button
Click on + New Button to begin configuration.
3. Enter Basic Button Details
| Field | Description |
| Internal Name | Unique name for internal reference. |
| Display Name | Name shown to end users on the interface. |
| Button Colour | Pick a color for visual distinction. |
| Item Listing Selection | Choose how items are listed: - List All: Display all items. - Pull Down Menu: Dropdown menu for selection. - Look Up: Search field for item lookup. |
| Group Name | (Optional) Used to group buttons for better organization. Required if the button is to be accessed from the Virtual Terminal or Contact Details Page. Group Names can be created and assigned later. |
📥 Load Item Lookup Report
Choose a data source for item records:
Option 1: Select Existing Salesforce Report
- Choose an existing saved report from your folders.
- Navigate to: Select Folder → Choose Report
- The report columns will be available for field mapping.
Option 2: Upload CSV File
- Upload a .csv file containing item records.
Note: The maximum number of records allowed to be added to buttons is 2,000 when using either a Salesforce Report or a .csv file, if the Contact field is not mapped.
However, if the Contact field is mapped, the system supports more than 2,000 records.
🔗 Mapping Fields
Link each record's fields to the item configuration. The following mappings are available:
| Field | Datatype | Required |
| C&P Account Number | Numerical | Optional |
| Contact ID | Numerical | Optional |
| Item Name | Text | Required |
| Lookup | Text | Optional |
| SKU | Alphanumeric | Optional |
| GAU | Alphanumeric | Optional |
| Unit Price | Numerical | Optional |
| Quantity | Numerical | Optional |
| Unit Discount | Numerical | Optional |
| Unit Tax | Numerical | Optional |
| Tax Deductible % | Numerical | Optional |
| Fair Market Value | Numerical | Optional |
| Item Campaign | Numerical - SF Campaign ID | Optional |
⚠️ Fields should be mapped according to their datatype.
🔍 Preview and Process
Once mappings are completed:
- Preview Button: View the top 10 records to ensure proper configuration.
- Process the Records: Click Process the Records at the bottom of the page to activate the button.
💡 How the Button Works
After configuration, the button becomes accessible from the Virtual Terminal and the Contact Details Page. Users can:
- View predefined items,
- Select from menus or perform lookups,
- Ensure consistent and streamlined transactions.
This improves both data accuracy and user efficiency.
🔄 Automatic Sync to VT
After saving in Settings, the system automatically publishes and syncs the new group and buttons to Virtual Terminal (VT)—no manual publishing required.
Locate Groups Control in Payment Details
Open VT and go to the Payment Details section.
Verify there are two buttons near items:
Add Items button
Groups button.
Select a Group
Click the Groups button.
A dropdown lists all groups synced from Settings.
Select the group from the list.
Select a Specific Button to Load Items
Click the Button button.
The items configured for that button will load into Payment Details.
Items may be edited.
➕ Add Button to Contact Details Page
To enable button access from a contact record, follow these steps:
Step 1: Open the Page Layout Editor
- Navigate to: Contacts → Page Layouts
- Select the desired layout (e.g., Contact Layout)
Step 2: Locate and Add Component
- Find: C&P VT Dynamic Buttons
- Location: Under Custom Components
- Drag and drop the component into the layout.
Step 3: Configure the Group
- Set the Field Name.
- Select the appropriate Group Name from the dropdown (created during button setup).
Step 4: Save and Verify
- Save the layout.
- Visit any Contact record to confirm that the C&P VT Dynamic Buttons section is visible.
✅ Summary
The Button Concept in the Click & Pay Suite is a user-friendly way to control item listings, integrate structured data from reports or CSVs, and offer seamless access to items for transactions—all directly within the Salesforce environment.
By following the steps in this guide, you can create powerful buttons that:
- Centralize item logic,
- Improve transaction flow,
- Reduce manual entry and errors.