Table of Contents
General Settings
Setting SKU and GAU for a Product
Assigning CONNECT Campaign URL Alias to the Form
Custom Questions
Handling Donations when the option OTHER is selected
Label for Payment method when Payment methods are set to Conditional Logic
APM (Alternate Payment Methods)
Setting Campaign for a Product
Setting an Item Name for a Product
Setting up a Tracker for Transaction
Addition of Double the Donation
How to Add reCAPTCHA to Gravity Forms
Addition of various parameters in the Thank You page
API Information
References:
Support:
Requirements:
- Gravity Forms requires a minimum of WordPress version 3.7+
- MySQL 5
- PHP 5
Setup:
- Go to ‘plugins->Installed Plugins’ enable the ‘Gravity Forms Click & Pledge’
- Please follow the documentation here to create a form https://docs.gravityforms.com/create-a-new-form/
- Click on ‘Forms->Click & Pledge’ to display all available forms
- Select the ‘Gravity Form’ to process then click on ‘Save’ button
Note: The current version of Click & Pledge Gravity Forms is 26.05000000-WP6.9.4-GF2.10.1. After updating to this version, users will need to follow these steps to ensure that the forms work correctly.
- Deactivate the Click & Pledge for Gravity Forms plugin in WordPress
- Reactivate the plugin
- Then reconnect your Click & Pledge account
Enter the CONNECT User Name associated with your Click & Pledge account and click on Get the Code. Please check your email inbox for the email. Copy the Code.
Paste the copied code and click Login.
The CONNECT Payment settings will be replicated here. Only Custom Payment can be edited here. Please login to Portal and go to Account Info > Accepted Cards to enable the payment type settings. Enable/Disable Send Receipt to Patron to send/stop the default receipt to the patron. To send the custom receipt to the patron, add the CONNECT Campaign URL Alias to the form. To change the user, click on Change User.Adding C&P Order Mode to the Form
From version 3.700.000, C&P Order Mode is removed from the general settings. So, in order to test the form, drag and drop the ‘C&P Order Mode’ button from ‘Pricing Fields’ sections. Enter the field label, description and select the mode before updating the form.
Mode may be set either to Test or Production. Test mode is used to test the transactions. No amount will be deducted from the payment. Production mode is nothing but live payment form wherein the given amount will be deducted from the selected payment type.
NOTE: If C&P Order Mode is not selected, by default the mode is set to Production.
Setting SKU and GAU for a Product
Add a hidden field:
Example 2:
- fid = Field ID of the product as listed in the Product listing
- value = Option's value- each option of a product has to be set up with a unique value and that value needs to be listed to identify the SKU's reference.
& the SKU value as set in the Advanced tab. SKU = Small
Option: Medium
Custom Questions
The following fields are posted as custom questions:
- Single Line Text
- Drop Down
- Number
- Radio Buttons
- Paragraph Text
- Multi Select
- Checkboxes
- Hidden
In the Donation page, If you are going to select the option “Other”, then please make sure to change these settings in the “Form Editor” page.
Step 1: Click on “Forms”.
Step 2: Select the Form name and click on “Edit”. It will redirect to the below screen.
For the Label “Other”, change the Value to “{SKIPIF0}” so that it won’t post duplicate items to Salesforce Opportunity Object.
The Other field can be added by dragging it from Add Fields > Product from Pricing Fields as shown in the below Image:
Drag the Product:
At Field Settings you need define the Field Label and Field Type.
Label for Payment method when Payment methods are set to Conditional Logic
Note: New versions of the Gravity Forms Click & Pledge plugin 26.02000000-WP6.9.1-GF2.9.27 include dedicated Payment Method buttons, so it is no longer necessary to create a separate Radio Button field under Standard Fields for selecting payment methods. The previous radio‑button configuration remains fully supported for backward compatibility and will continue to work as documented below.
Important (reCAPTCHA & Bank Account): When offering Bank Account as a payment option, you must use the Payment Method buttons configuration rather than the Standard Fields radio buttons to avoid conflicts with reCAPTCHA and ensure secure, error‑free processing of bank payments.
Please note that the conditional logic for the payment methods remains the same as specified in the steps below.
If there are multiple options for payment methods, please follow the below procedure to know how to set the conditional logic.
- From ‘Standard Fields’ section, Drag and drop the ‘Radio Button’ field into the Form Editor.
- Enter the Field Label as Payment Method . Make sure that label name will be any one of these: Payment Method / Select Payment Type / Select Payment Method
- Enter the Choices of the payment methods. Enable the radio button of the desired payment method so that it will be the default payment method in the payment page.
4. Payment Method Values
When adding a Payment Method to the form, the Label can be customized; however, the Values must be set exactly as shown below for the payment methods to function properly:
-
Credit Card → C
reditCardorCredit Card -
eCheck →
eCheckore check -
PayPal →
paypalorpay pal -
Google Pay →
gpayorGpay -
Amazon Pay →
Amazon Payoramazon pay -
Bank Account →
Bank Accountorbank account
Credit Card:
- From ‘Pricing Fields’ section, Drag and drop the ‘Credit Card’ field into the Form Editor.
- Go to Advanced tab, Enable the checkbox for the field ‘Enable Conditional Logic’.
- Select Payment Method from the dropdown menu followed by IS condition and select Payment method as Credit Card .
- From ‘Pricing Fields’ section, Drag and drop the ‘eCheck’ field into the Form Editor.
- Go to Advanced tab, Enable the checkbox for the field ‘Enable Conditional Logic’.
- Select Payment Method from the dropdown menu followed by IS condition and select Payment method as eCheck .
- From ‘Pricing Fields’ section, Drag and drop the ‘Custom Payment’ field into the Form Editor.
- Go to Advanced tab, Enable the checkbox for the field ‘Enable Conditional Logic’.
- Select Payment Method from the drop-down menu followed by IS condition and select Payment method as Custom Payment .
After updating the form, the payment page looks like the below screenshot. Select the desired payment method and process the donation.
- All APMs works only in the Production mode. Apple Pay is not supported in an iframe or on unregistered domains due to cross-domain restrictions and Apple's policies.
- When using Alternative Payment Methods (APM), it is required to add either reCAPTCHA v2 Invisible or reCAPTCHA v3 Invisible to your Gravity Form. This is necessary to ensure the form processes securely and avoids unexpected errors during submission.
- There are multiple conditions that must be satisfied to display Google Pay as a payment method.
- A patron needs to have a valid credit card saved to Google Pay.
- Google Pay only shows on Chrome, a web browser developed by Google. The Chrome browser needs to be an updated version.
- When using Chrome Google Pay needs to be connected.
Patron will select their Bank from the list provided or may use the Search filed to find their bank. When they Select their bank the will see the following screen.
How to Build a Gravity Form with Recurring and One-Time Options
Single/Double click on Recurring button (Pricing Fields > Recurring), so that it will appear in the form editor.
1. Field Label: Enter the Label of the form field. This is the field title the user will see when filling out the form.
2. Description: Enter the description for the form field. This will be displayed for the user and provide some direction on how the field should be filled out or selected.
3. The name mentioned here for the payment methods will be displayed in the external page.
4. By enabling the checkbox for “One time only”, the user can select either “One time only” or “Recurring” from the external page. If not selected, the user can perform only recurring transaction. SKU Suffixes allow you to create additional parameters to increase the flexibility of information included in a SKU. This is particularly helpful with Salesforce mapping.
5. Default Payment Options: The option which is selected here will be displayed as a default option in the external page.
6. The name mentioned here for the recurring types will be displayed in the external page.
7. Select either installment or subscription or both. The selected options will be displayed in the external page.
8. Default Recurring Type: The selected option will be displayed as the default recurring type in the external page.
NOTE: If both the options are selected in the step: 7, then only “Default Recurring Type” will appear.
9. The name mentioned here for the periodicity will be displayed in the external page.
10. The checkboxes which are selected will be displayed in the external page. SKU Suffixes allow you to create additional parameters to increase the flexibility of information included in a SKU. This is particularly helpful with Salesforce mapping.
11. The name mentioned here for the number of payments will be displayed in the external page.
12. Indefinite Only: If this option is selected then 998 times for installments and 999 times for subscription, the recurring option will be continued.
Open Field Only: If this option is selected, “Default number of payments” and “Maximum number of installments” can be given. The entries given here can be changed in the external page.
Indefinite + Open Field Only: If this option is selected, the default value will be 999 which can be changed accordingly in the external page.
NOTE: Make sure the range for installment is 2 to 998 and 2 to 999 for a subscription.
Fixed Number: If this option is selected, the number entered in this field remains constant.
13. Rules: Select the option to make the form field required. A required field will prevent the form from being submitted if it is not filled out or selected.
A recurring transaction can be done through Credit Card and eCheck. Here are the steps to add Credit Card and eCheck into the form editor.
Credit Card and eCheck can be added from Pricing Fields . Single/Double click on the button so that they will be added to the form editor.
After adding all the required fields to the form editor, click on Update Form. The external page for above fields will look like this:
NOTE 1: If the plug-in is updated then the already existing forms will also be updated without any change in the settings which are already set for the form.
NOTE 2: If the settings want to be changed for Recurring process then delete the field and click on “Update form” button. Then select the recurring field from Pricing Fields tab.
Setting Campaign for a Product
NOTE: These steps are applicable only from Version 3.x and above.
Campaign feature provides a flexible method for tracking donations across different channels. The following steps clearly explain how to add a campaign to the product.
Step 1: Add the product to the form editor.
1. After login to the Gravity Forms, click on Form.
2. Select New Form and provide the forum name and description.
3. Click on Pricing Fields, so that the options will appear.
4. C lick or drag the Product button so that it will appear in the form editor.
Step 2: Add the Campaign to the form editor.
1. Click on Standard Fields, so that the options will appear.
2. Single/Double click on Hidden button so that it will appear in the form editor. Click on Hidden Field so that the Field Label column will be visible.
3. Replace the Field Label with {CAMPAIGNNAME}{FIELDID=} or {CAMPAIGNNAME}{FIELDID=1}.
Campaigns are of two types. They are Transaction Campaign and Item Campaign.
Transaction Campaign:
Transaction Campaign will have Empty Field id.
Eg: - {CAMPAIGNNAME}{FIELDID=}
Item Campaign:
Item campaign has the Product Field Id number instead of null.
Campaign Name:
1. Click on Advanced button.
2. Default Value: If you would like to pre-populate the value of a field, enter it here.
3. Check this option to enable data to be passed to the form and pre-populate this field dynamically. Data can be passed via Query Strings, Shortcode and/or Hooks.
Example: 1
For products with options such as those listed in a pull-down menu or a radio button, each option needs to be set up with a Campaign. Campaigns may be the same or different.
Hidden field format: {CAMPAIGNNAME}{FIELDID=FID}{OPTION=VALUE}
- fid = Field ID of the product as listed in the Product listing
- value = Option's value- each option of a product has to be set up with a unique value and that value needs to be listed to identify the Campaign's reference.
The field label: Reference the Field ID of the item as shown in the item's blue label area.
& the Campaign value as set in the Advanced tab. Campaign = WHO-Cancer-Small
Option: Medium
& the Campaign value as set in the Advanced tab. Campaign = WHO-Cancer-Medium
Option: Large
& the Campaign value as set in the Advanced tab. Campaign = WHO-Cancer-Large
Set up the hidden field referencing the Field ID as in the Product setting.
Tracker can be added to the Transaction as hidden field.
When this feature is enabled, Double the Donation will be integrated into the form. This allows donors to check if their employer offers matching gift program.
Note: This feature is only available if you have an active Double the Donation (DTD) connection linked to your C&P account. To enable the Double the Donation please refer to the following KB article: https://support.clickandpledge.com/s/article/connect-third-party-integration#Double_the_Donation
Tax Deductible Feature for Products
This feature allows you to mark a product (such as a donation) as tax deductible, either by fixed amount, percentage, or fair market value (FMV).
Add the Tax Deductible Field:
Drag the Tax-deductible to the form "C&P Tax Deductible". Place it below your Product field in the form.
Key Settings:
-
Apply to Product
Select the product field (e.g., Field #23 — Price) to which the tax deduction applies. -
Tax Deductible Type
Choose one:
1. Tax Deductible $ → Fixed deductible amount
2. Tax Deductible % → Percentage of product price
3. FMV → Fair Market Value deduction -
Deductible % / Amount
Enter the value based on your selected option (e.g., 50%). -
Required (Optional)
Enable if this selection must be applied before submission.
How to Add Cloudflare Turnstile to Gravity Forms
Please note that to use the Cloudflare Turnstile, you will need to install the "Gravity Forms Cloudflare Turnstile Add-On".
Now, you can add Gravity Forms Turnstile to any form using the form builder.
To add the Turnstile field, simply drag and drop the Turnstile form field (under Advanced Fields) to your form. Click the Update button to continue.
Note: Choose the widget type (Managed/Invisible) based on user experience preference.
With Turnstile, the external page looks like this:
How to Add reCAPTCHA to Gravity Forms
reCaptcha v2 Settings:
Setting up Gravity Forms reCAPTCHA v2 in WordPress is incredibly easy and you don’t have to use a separate plugin.
Enter the reCAPTCHA Site Key and Secret Key under the reCAPTCHA Settings option. You can also select which type of reCAPTCHA to add to your WordPress forms – Checkbox or Invisible. Click the Save Settings button to proceed.
Now, you can add Gravity Forms reCAPTCHA to any form (whether it’s a registration form or a contact form) using the form builder.
To add the reCAPTCHA field, simply drag and drop the CAPTCHA form field (under Advanced Fields) to your form. Click the Update button to continue.
With reCAPTCHA, the external page looks like this:
After creating the form with all the necessary parameters added, we need to assign the form to Click & Pledge Payment Gateway. To do so, go to Forms > Click & Pledge > Add New (Click it).
Select the created form and click Save.
You can view the newly added form in the Click & Pledge Forms Dashboard.
To process the form from Click & Pledge payment gateway, the above procedure is mandatory.
Addition of various parameters in the Thank You page
To add various parameters like order number, transaction Id, Auth Code, Payment Amount and Payment status in Gravity Forms Thank you Page, please follow the below steps:
Go to Gravity Form > Forms
After selecting Confirmation, click on Edit.
You may edit the confirmation page and customize the page as needed. The following parameters are present by default:
Transaction details:
Order Number: {order_number}
Authorization Code: {authcode}
Payment Amount: ${payment_amount}
Payment Status: {payment_status}
After successful transaction, Thank you page will appear like below: