Optional Configuration
Prepopulate Virtual Terminal Fields
Map fields from the Transaction's Parent Object to the Terminal's Transaction screen using a Custom Metadata Type called, "Virtual Terminal Mapping."
Please make sure the fields mapped have the same field type and property. For example, if you created a custom field to prepopulate currency, make sure it matches the same format as the currency field on Transaction.
Fields that can be prepopulated:
Related To
Payment Method
Description
Amount
Currency
Email
Holder's Name
Note: This is for Credit Card Payment Methods only at this time.Custom fields
Navigate to Custom Metadata Types.
Lightning/Classic: Navigate to Setup | In the Quick Find / Search, type in and select " Custom Metadata Types."
-
Click "Manage Records" next to Virtual Terminal Mapping.
-
Click
New
. -
Add values to the following fields:
Virtual Terminal Mapping Name
This is the API name for the record. The API name can only contain underscores and alphanumeric characters. It must be unique, begin with a letter, not include spaces, not end with an underscore, and not contain two consecutive underscores.
For example, "opp_amount."
Label
This is the label for the particular prepopulating record.
For example, use "Opp->Trans Amount" for the label if you are prepopulating the amount field.
Screen
Single Transaction.
Use the Related To screen for prepopulating the "Related To" field on the Terminal's Transaction screen. See example here.
Source Object
Select the Parent Object.
For example, the Opportunity Object.
Source Field
Select the field you want the value to come from.
For example, if you want to prepopulate the Terminal's Transaction amount with the Opportunity's amount, then select the amount field from the list.
Target Object
select Transaction [bt_stripe].
Target Field
Select the field you want the value to populate in.
For example, you would select the Amount field.
- Click
Save
.


Add or Remove Virtual Terminal Fields
Adding, removing, and modifying fields on the Virtual Terminal is done through Field Sets. A Field Set is a grouping of fields that can be displayed on Lightning Components. Where a user can add, remove, or rearrange fields from the Field Set, without altering the Lightning Component.
Formula and auto-number fields cannot be added to the fieldset.
Virtual Terminal Transaction Configuration
-
Navigate to the Transaction object in Setup.
-
Click
Field Sets
. -
Click
Edit
next to Virtual Terminal. -
Remove, add, and modify the fields within that box to fit your use case.
Fields "In the Field Set" box are the fields currently on the Virtual Terminal's Transaction screen.
- Click
Save
.




New Record Screen
New record screen allows you to create new records from the "Related To" field on the Virtual Terminal.
Account and Contact
The Account and Contact "New Record" screens have predefined fields available and a FieldSet record is automatically created.
- Navigate to the Account or Contact Object in Setup.
2.Click Field Sets
.
-
Click
Edit
next to "Virtual Terminal." -
Remove, add, and modify the fields within that box to fit your use case.
Fields "In the Field Set" box are the fields currently on the Virtual Terminal's new Account or Contact record screen. -
Click
Save
.


Contact Fieldset
Other Objects
Related To objects besides Account and Contact, show a blank "New Record" screen. In order to create new records, you will need to manually create a Field Set.
For example, the new Lead screen looks like this before adding a FieldSet:


-
Navigate to the Lead Object in Setup.
-
Click
Field Sets
. -
Click
New
. -
Add values to the following fields:
Field Set Label
Virtual Terminal.
Field Set Name
VirtualTerminal.
_If the Field Set Name
value is different than above, the fields will not display on the Virtual Terminal screen.
Where is this used?
Description of this Field Set. For example, "Virtual Terminal for the new Lead record screen."
-
Drag the fields you want to use for creating a new Lead record "In the Field Set" box.
-
Click
Save
.


The screen now has fields and can create new Lead records!
Updated over 1 year ago