PatronManager Help

How to Set Up Payment Requests

Updated on

Use this link to share with your colleagues:

How to Set Up Payment Requests: https://help.patronmanager.com/a/2087693

So you've decided to take advantage of Payment Requests. In order to begin using Payment Requests and creating Payment Request Forms, there are a few set up steps you'll need to take first.

In this article, we'll take you through these one-time set up steps:

  1. Add the Request Payment Action to Page Layouts
  2. Optionally, review and edit the Payment Request email templates

Let's get started!

1. Adjust Page Layouts

First, in order to take advantage of Payment Requests, you'll need to add the Request Payment action to your page layouts.

1.1. Go to Setup

Setup

1.2. Go to Object Manager

Object Manager

1.3. Find and select Donation

Donation

1.4. Go to Page Layouts

Page Layouts

1.5. Click into the Page Layout you wish to edit

Select a Page Layout

In this example, we'll select Rental Payment Layout for Facility Rentals.

Why are we here in Donations when Facility Rentals are their own object?

Rentals, Rental Inventory, and Rental Items are indeed separate objects in PatronManager. But Rental Payments share the donation payment processing infrastructure. 

1.6. Click Mobile & Lightning Actions in the palette

Mobile & Lightning Actions

1.7. Drag and drop Request Payment from the palette to the Salesforce Mobile and Lightning Experience Actions section

Request Payment to Salesforce Mobile and Lightning Experience Actions

We recommend moving this action after "Process Credit Card Transaction" but before "Refund!"

We have recommendations for how to best order these actions here.

1.8. Save your work

Save

Repeat steps 1.5-1.8 for any other Page Layouts you wish!

Our recommendation is to add the Request Payment action to the following layouts:

Do not add the Request Payment action to parent Record Type page layouts (such as Grant, Group Sale, or Pledge), as these Record Types are used only to organize related payment records. Because Payment Requests are used to collect payments, the action should be available only on Record Types that represent an actual payment, such as Grant Payment, Group Sale Payment, and Pledge Payment.

2. Review and edit Payment Request emails (optional)

With Payment Requests, there are two pre-built email templates:

  • Payment Request Notification Template - this goes out to the Contact when you send them a Payment Request by clicking "Request Payment" from a record
  • Payment Request Confirmation Template - this goes to a Contact after they fill out a Payment Request Form

These templates have default text, so you can start using Payment Requests right away. But your organization may wish to review or edit the templates to match your voice and branding.

You can also create different email templates for each different Payment Request Form. You can make a different Payment Request Form for each Donation Record Type.

Like all other Visualforce templates, if you'd like to make a copy you will need to copy the code from the existing template and create a new one.

You cannot use the "Clone" button to clone Payment Request email templates.

Expand or collapse content I'd like to edit the existing templates

2.1. Go to Setup

Setup

2.2. Find and select Classic Email Templates

Classic Email Templates

2.3. Select the Payment Request Email Templates Folder

Payment Request Email Templates

2.4. Select the template you wish to review or edit

Select template

Make sure to click the Email Template Name!

From here you can edit the template as you wish

For details on editing Visualforce templates like this one, check out our steps here.

Before you can test the template from the template editor, open a record that includes the Request Payment action and click the button. This will open the Payment Request window but will not send a request or take any other action. Close the window, then return to the template editor—you'll now be able to use that record when testing the template.

If you run into the following error, take those steps and make sure you've selected that record:

"Error occurred trying to load the template for preview: Unable to generate url: No active Payment Request Form found for this Opportunity record type.. Please try editing your markup to correct the problem."

Here's what the default templates look like
Payment Request Notification Template
Payment Request Notification Template

Everything except the Payment Details box in this template is editable.

Payment Request Confirmation Template
Payment Request Confirmation Template

Everything except the Payment Details box in this template is editable.

Need to revert back to the original template? Here are the codes
Payment Request Notification Template
<messaging:emailTemplate subject="Payment Confirmation for {!relatedTo.Name}" recipientType="Contact" relatedToType="Opportunity">
    <messaging:htmlEmailBody >
        <p>Dear {!recipient.FirstName},</p>
        <p>This email confirms that we’ve received your payment for {!relatedTo.Name}. Thank you for your payment.</p>
        <c:PaymentRequestDetails opportunityId="{!relatedTo.Id}" mode="completed"/>
        <p>We’ll be in touch with additional details as applicable. If you have any questions, feel free to reach and we’ll be happy to assist.</p>
        <p>Thank you,</p>
        <p>{!$Organization.Name}</p>
    </messaging:htmlEmailBody>
</messaging:emailTemplate>
Click to copy
Payment Request Confirmation Template
<messaging:emailTemplate subject="Payment Due for {!relatedTo.Name}" recipientType="Contact" relatedToType="Opportunity">
    <messaging:htmlEmailBody >
        <p>Dear {!recipient.FirstName},</p>
        <p>This message is to let you know that payment for {!relatedTo.Name} is due.</p>
        <p>Please submit your payment below.</p>
        <c:PaymentRequestDetails opportunityId="{!relatedTo.Id}" />
        <p>Please feel free to reach out if you have any questions or need assistance.</p>
        <p>Thank you,</p>
        <p>{!$Organization.Name}</p>
    </messaging:htmlEmailBody>
</messaging:emailTemplate>
Click to copy
Expand or collapse content I'd like to create some new templates

You can create a different email template for each Payment Request Form you create!

Before creating the new templates, make sure that you have a Donation Record Type for each kind of Payment Request Form you plan to create. If you need to create a custom Donation Record Type, you can do so.

2.1. Go to Setup

Setup

2.2. Find and select Classic Email Templates

Classic Email Templates

2.3. Select the Payment Request Email Templates Folder

Payment Request Email Templates

2.4. Click New Template

Select template

2.5. Choose "Visualforce" and click "Next"

Visualforce and Next

2.6. Fill out the Email Template Information fields and Attributes

Email Template properties
  1. Available For Use: Check
  2. Email Template Name: Give a name that makes sense for you and your team
  3. Description: Give a description to help you and your team know what this is used for
  4. Subject: The subject line for the email; will be seen by donors
  5. Email Subject: Copy the Subject
  6. Recipient Type: Contact
  7. Related To Type: Opportunity
  8. Save

2.7. Click "Edit Template"

Edit Template

2.8. Delete the existing code in the template

Delete the code

2.9. Paste in the Visualforce code from the default template

Paste default code

We've got the template codes below for the defaults for you!

Expand or collapse content Payment Request Notification Template
<messaging:emailTemplate subject="Payment Confirmation for {!relatedTo.Name}" recipientType="Contact" relatedToType="Opportunity">
    <messaging:htmlEmailBody >
        <p>Dear {!recipient.FirstName},</p>
        <p>This email confirms that we’ve received your payment for {!relatedTo.Name}. Thank you for your payment.</p>
        <c:PaymentRequestDetails opportunityId="{!relatedTo.Id}" mode="completed"/>
        <p>We’ll be in touch with additional details as applicable. If you have any questions, feel free to reach and we’ll be happy to assist.</p>
        <p>Thank you,</p>
        <p>{!$Organization.Name}</p>
    </messaging:htmlEmailBody>
</messaging:emailTemplate>
Click to copy
Expand or collapse content Payment Request Confirmation Template
<messaging:emailTemplate subject="Payment Due for {!relatedTo.Name}" recipientType="Contact" relatedToType="Opportunity">
    <messaging:htmlEmailBody >
        <p>Dear {!recipient.FirstName},</p>
        <p>This message is to let you know that payment for {!relatedTo.Name} is due.</p>
        <p>Please submit your payment below.</p>
        <c:PaymentRequestDetails opportunityId="{!relatedTo.Id}" />
        <p>Please feel free to reach out if you have any questions or need assistance.</p>
        <p>Thank you,</p>
        <p>{!$Organization.Name}</p>
    </messaging:htmlEmailBody>
</messaging:emailTemplate>
Click to copy

2.10. Find and replace "<c:PaymentRequestDetails" with "<PatronDonate:PaymentRequestDetails"

Replace some code

2.11. Customize the template

Customize the language of the template to your heart's content! Here are a few tips:

  • Make sure to adjust the text in the quotation marks for the emailTemplate subject in line 1 to your desired email subject line
Email subject

2.12. When you're done, click Save

Save

Now you can use this custom template!

You'll assign it to a Payment Request Form and Donation Record Type when you create a Payment Request Form in step 3.

Previous Article All About Payment Requests
Next Article How to Create Payment Request Forms
Still Need Help? Continue to the Client Community