Overview
Merchant Central allows ISOs and their teams to upload, configure, and manage e-signature documents, making it easier to collect completed applications, agreements, and other signed documents from merchants.
For instructions on sending agreements to merchants, see the Sending Agreements for E-Signature article.
Mapping e-signature document fields to lead fields lets you automatically populate documents with existing merchant information. This reduces manual data entry, improves accuracy, and makes signing more convenient for merchants.
You can also include editable fields so merchants can provide additional information on the e-signature page. After the document is signed and submitted, Merchant Central automatically transfers that information to the corresponding lead fields.
This guide explains how to set up and manage e-signature documents in Merchant Central. You will learn how to:
- Prepare a PDF for e-signature.
- Upload and configure an e-signature application.
- Map PDF fields to lead fields using the Visual PDF Mapper.
- Update PDF documents and manage existing field mappings.
Prerequisites
Before creating an e-signature application, ensure you have:
- Adobe Acrobat or similar software that supports editing PDF form fields.
- The Manage E-Sign PDFs & Mappings permission assigned to your user class.
By default, users can access all e-signature applications on the E-Signature management page. To limit access to applications assigned to a user’s groups, contact Support to enable the PDF_GROUPWIDE_PERMISSION feature flag on your site.
Step 1: Preparing the PDF Document for E-Signature
Before uploading your PDF to Merchant Central, go through the following checklist to ensure that your document meets the e-signature requirements.
PDF Preparation Checklist
- Remove password protection: If the PDF is password-protected, remove the protection. For instructions, see Unlocking PDF Files.
-
Configure PDF form fields: Make sure the PDF includes:
- Text fields and/or checkboxes to map to the corresponding lead fields in Merchant Central.
- At least one email and one signature field for every signer.
You can also configure these optional features:
- Set text fields and checkboxes as editable, read-only, or required for the merchant.
- Add fixed values directly to the document.
- Add file upload fields so merchants can attach supporting files when signing.
- Add signer-specific or calculated fields.
For detailed instructions on adding text fields, checkboxes, and signature fields, see our article on Preparing PDF Forms for E-Signature.
Step 2: Creating and Configuring the E-Signature Application
After preparing the PDF, upload it to Merchant Central and configure how the document is generated, delivered, and managed.
You can combine existing E-Signature Applications into an E-Signature Bundle, allowing merchants to sign multiple documents in a single E-Signature session. For step-by-step instructions, see our guide on Managing E-Signature Applications.
Accessing E-Signature Applications
- Open the navigation panel in Merchant Central and select the E-Signature section.
- Click Import PDFs.
The Manage Applications page lists your existing e-signature applications.
Adding a New E-Signature Application
- On the Manage Applications page, click Add New Application.
- Configure the options in the application settings window.
- Select the PDF you want to upload.
- Click Save.
After you save, the application appears on the page. From there, you can edit its settings and configure field mappings.
Configuring Application Settings
Application settings determine how the document is displayed, generated, and delivered to merchants.
- Category: Determines where the document appears in the e-signature dropdown on a lead.
- Application Type: Select eSignature Application, Generic Form (without e-signature capability), or eSignature Bundle.
- Display Title: The title shown in the e-signature document dropdown on a lead.
- Document Name: The filename of the PDF saved to the lead.
- Label (Unsigned): The label applied to the generated PDF on the E-Sign tab.
- Email Template: The email template shown when an e-signature document is generated.
- Signed Template: The confirmation email sent automatically after the merchant signs.
- Signed Notification: Determines whether the confirmation email and signed document go to both the sender (such as the sales representative) and recipients, or to recipients only. You can choose whether to attach the signed PDF to the sender’s copy.
- Signed Lead Status: Automatically changes the lead to the selected status when the document is signed.
- Password Field: Uses the last four characters of a selected secure field as the password for generated PDFs.
- Label (Signed): The label applied to the signed document.
- Confirmation Page: The page displayed to the merchant after completing the signature process.
- Help Banner: A customizable banner for displaying contact or support information on the signing page.
Step 3: Mapping E-Signature Documents to Lead Fields
After configuring the e-signature application, map its PDF fields to the corresponding lead fields with the Visual PDF Mapper tool.
The Visual PDF Mapper lets you drag and drop lead fields onto fields in an uploaded e-signature document.
For example, you can map business names, addresses, contact details, and other lead information to the corresponding PDF fields.
When you generate an e-signature document from a lead, Merchant Central automatically fills the mapped PDF fields with that lead’s information.
You can also use the mapper to:
- Map lead dropdown selections to PDF text fields or checkboxes.
- Automatically fill fields with sales representative information.
- Find, update, or delete existing mappings.
- Copy mappings from another e-signature application.
Each mapping is saved as a Lead ID # and PDF Field Name pair. Remember this when replacing a PDF in an existing e-signature application: even if the replacement PDF looks identical, its internal field names may differ. If they do, existing mappings may stop working.
Opening the Visual PDF Mapper
- On the Manage Applications page, find the application you want to map.
- Click the Mappings button for that application.
The Visual PDF Mapper opens, displaying lead fields on the left and the PDF document on the right.
The mapper uses colors to indicate mapping status:
- Grey: The PDF field has no mapping.
- Green: The field is mapped. The lead field and its corresponding PDF field appear in green.
Mapping Lead Fields to PDF Fields
To create a mapping, drag a lead field from the left panel to the corresponding PDF field.
- Find the lead field you want to map on the left side of the Visual PDF Mapper.
- Find the matching field in the PDF on the right.
- Drag the lead field onto the PDF field to create the mapping.
- Repeat for any other fields you want to populate automatically.
The following mappings are supported:
- Lead text field to PDF text field.
- Lead checkbox to PDF checkbox.
- Lead dropdown to PDF text field.
- Lead dropdown option to PDF checkbox.
You can map a single lead field to multiple PDF fields so its value appears in multiple places. However, each PDF field can be mapped to only one lead field.
Mapped fields appear in green.
For a demonstration, see the video in the Video Tutorial section below.
Auto filling Sales Representative Information
You can automatically populate PDF fields with details of the sales representative sending the document.
To set up autofill:
- Select the PDF field you want to populate.
- Choose the sales representative detail you want to insert from the dropdown.
- Click Add.
Available details include the sales representative’s name, job title, email address, phone number, mobile number, fax number, extension, and date formats.
Saving PDF Mappings
After mapping the required fields, click Save in the upper-right corner of the mapper.
Deleting an Existing Mapping
To remove a mapping from the PDF:
- Hover over the mapped field in the PDF.
- Click the Delete icon that appears.
Alternatively, remove the mapping from the lead panel:
- Click the mapped lead field.
- Find the mapping in the list that appears.
- Click the Delete icon.
Changes to mappings are not saved automatically. Click Save after adding, updating, or deleting a mapping.
Finding a Mapped Field
The Visual PDF Mapper includes tools to help you find mapped fields in large documents.
To locate the lead field associated with a PDF field, click the mapped PDF field. The lead panel scrolls to the matching field and highlights it in blue.
To locate the PDF field associated with a lead field, select the mapped lead field and click the Search icon.
The PDF scrolls to the matching field and highlights it in blue.
Additional Tools in the Visual PDF Mapper
You can return to the Visual PDF Mapper whenever you need to update documents or mappings.
Use the shortcuts at the top of the mapping page to copy mappings from another e-signature application, upload updated PDFs, export mappings to CSV, or review mapping history.
Copying Mappings from Another Application
To reuse mappings from another e-signature application rather than recreating them manually, follow these steps:
- Click Settings > Copy Mappings.
- Select the application you want to copy mappings from.
- To delete the current mappings before copying, select Clear previous mappings.
- Click Copy.
Verify that the copied mappings match the intended PDF fields.
Copy Mappings works correctly only if the source and destination PDFs have identical field names.
Uploading an Updated PDF
To replace the existing PDF with a revised version, click Upload in the upper-right corner of the mapper.
After uploading, verify that existing mappings still point to the correct fields, especially if field names or the PDF structure have changed.
Download a backup copy of the current PDF before uploading a replacement. Merchant Central does not retain previous versions of uploaded PDFs; only the current version is stored. For safekeeping, store backup copies in the Documents section of Merchant Central.
If you need to make a minor change to an e-signature application, such as making fields read-only, updating text, or adding your company logo, follow these steps:
- Download the PDF from the Manage Applications page.
- Open it in Adobe Acrobat, make your changes, and save the file.
- Upload the updated PDF to Merchant Central.
Keeping the original PDF field names unchanged helps preserve existing mappings. If you rename or remove fields, review and update the mappings after uploading the revised PDF.
Viewing Mapping History
To view an application’s mapping history, click History in the upper-right corner of the mapper.
The Mapping History window shows:
- PDF field name.
- Mapping change.
- Date and time of the change.
- User who made the change.
You can also search and export the mapping history.
Video Tutorial
This tutorial demonstrates how to map different types of lead fields to PDF fields using drag and drop, and how to configure autofill for sales representative information.