# Gravity Forms

## Overview

Gravity Forms is a WordPress plugin for creating custom forms. With Gravity Forms, users can easily build contact forms, surveys, and registration forms — without any programming knowledge.

With the plugin developed by the agency cloudWEB, Payrexx can be seamlessly integrated into Gravity Forms. This allows you to enable direct payments for your customers through forms created with Gravity Forms.

### Links

* Gravity Forms [Website](https://www.gravityforms.com/)
* Gravity Forms [Plugin](https://cldwb.ch/JtckIt)
* Gravity Forms [Documentation](https://docs.gravityforms.com/)
* [Register](https://www.gravityforms.com/registration/) for Gravity Forms
* Gravity Forms [Login](https://www.gravityforms.com/wp-login.php)
* Download the Payrexx Add-On for Gravity Forms
* Website of the plugin developer [cloudWEB](https://www.cloudweb.ch/)

{% hint style="info" %}
Please note that integration with Gravity Forms is only available in the Standard and Premium plans. [For more information](https://payrexx.com/en/prices)
{% endhint %}

### Features

* ✅ Complete purchases directly within Gravity Forms
* ✅ Customize the look & feel of the payment page
* ✅ Transfer customer and payment data to Payrexx
* ✅ Synchronize order status between Gravity Forms and Payrexx

## Integration

Follow the steps below to integrate Payrexx into Gravity Forms.

### Configuration of Payrexx

{% hint style="info" %}
Make sure you're [logged in](https://login.payrexx.com/) to your Payrexx account before you begin. If you don’t have a Payrexx account yet, you can [register](https://signup.payrexx.com/) now.
{% endhint %}

* In your Payrexx merchant dashboard, navigate to **API & Plugins**.
* Click on "Add API Key":

<div align="left"><figure><img src="/files/uTxADAzkw56jfSE3W1Ju" alt=""><figcaption><p>Starting the setup of an API Key in Payrexx</p></figcaption></figure></div>

* Assign a name of your choice to the integration and click the green "Add" button:

<div align="left"><figure><img src="/files/fQBA3tsJjMBjSn72RB7l" alt=""><figcaption><p>Creating the API Key for Gravity Forms</p></figcaption></figure></div>

* Copy the API key to your clipboard, as you will need it later when configuring Gravity Forms:

<div align="left"><figure><img src="/files/c6Velp5ZKk0aUx8kfbA3" alt=""><figcaption><p>Copying the API Key to the Clipboard</p></figcaption></figure></div>

### Configuration of Gravity Forms

* Log in to your WordPress account.
* Install the Gravity Forms plugin.
* Activate the license for the Gravity Forms plugin.
* Install and activate the [Payrexx Add-On for Gravity Forms](https://www.thenextstep.ch/extensions-uploads/payrexx-add-on-for-gravity-forms/payrexx-add-on-for-gravity-forms.zip).

<div align="left"><figure><img src="/files/IQ7ReiMKYFp2g78RKWcb" alt=""><figcaption><p>View in WordPress with installed and activated Plugins</p></figcaption></figure></div>

## Creating a Form

{% hint style="info" %}
For more information and a detailed guide on how to create forms, please visit the Gravity Forms [website](https://www.gravityforms.com/get-started-create-embed-form/).
{% endhint %}

* Follow the steps below to create a form using Gravity Forms and integrate the Payrexx payment solution.
* In the main menu of your WordPress dashboard, navigate to **Forms > New Form**.
* Select "Blank Form" as the template type:

<div align="left"><figure><img src="/files/Kr7xX98kvRGXHwLpptju" alt=""><figcaption><p>Creating a new "Blank Form" in Gravity Forms</p></figcaption></figure></div>

* Choose a title for your form and, optionally, add a description. Then click the "Create Blank Form" button:

<div align="left"><figure><img src="/files/SyeWuM0vEdMzcM9bc9Pc" alt=""><figcaption><p>Entering the title and description and creating the form</p></figcaption></figure></div>

* Use the drag-and-drop editor to add at least the following fields to your form:

<div align="left"><figure><img src="/files/PdRKz0J7zSANrxVmFcI6" alt=""><figcaption><p>Creating the form fields in Gravity Forms</p></figcaption></figure></div>

1. Name (Group: Standard Fields, Type: Single Line Text)
2. First Name (Group: Standard Fields, Type: Single Line Text)
3. Email (Group: Advanced Fields, Type: Email)
4. Product (Group: Pricing Fields, Type: Product)
5. Total (Group: Pricing Fields, Type: Total)
6. Payrexx (Group: Pricing Fields, Type: Payrexx)

{% hint style="info" %}
Please make sure to define an amount greater than 0.00 in the product field.
{% endhint %}

* Hover over "Settings" and click on "Payrexx":

<div align="left"><figure><img src="/files/GQ7u3gcV1QYDvEq3hpry" alt=""><figcaption><p>Opening the Payrexx Feeds in Gravity Forms</p></figcaption></figure></div>

* In the Payrexx Feeds section, click "Add New":

<div align="left"><figure><img src="/files/kQzxTVlI73yWYiy8WSyD" alt=""><figcaption><p>Adding a Feed in Gravity Forms</p></figcaption></figure></div>

* Enter a name for the integration (1), and under "Transaction Type", select "Products and Services":

<div align="left"><figure><img src="/files/1Y8tgNkg2rUWnF9duwd8" alt=""><figcaption><p>Configuring the feed in Gravity Forms</p></figcaption></figure></div>

After selecting "Products and Services", additional fields will appear.

* Ensure that the "Payment Amount" field is set to "Form Total".

<div align="left"><figure><img src="/files/t8SwMfHFBv30CCmqgkWX" alt=""><figcaption><p>Configuring the Payment Amount field</p></figcaption></figure></div>

* Configure the fields based on the following image:

<div align="left"><figure><img src="/files/ZWqoLlU9YVDYGLXLnGdf" alt=""><figcaption><p>Configuring the connection with Payrexx</p></figcaption></figure></div>

1. **API Key:** Paste the API key that you copied to the clipboard during the [Payrexx setup](#configuration-of-payrexx).
2. **Instance Name:** Enter the instance name of your Payrexx account. For example, if your account URL is *example*.payrexx.com, your instance name would be "*example*".
3. **VAT Rate:** Enter the applicable VAT rate for the country in which your customers are located.
4. **Currency:** Select your preferred currency.
5. **Success Confirmation:** Choose which confirmation message should be sent after a successful payment.

* Assign the corresponding "Form Field" to the fields you created:

<div align="left"><figure><img src="/files/oieTdevzmgfvgSIrvu6w" alt=""><figcaption><p>Assigning the form fields</p></figcaption></figure></div>

* Complete the configuration by scrolling to the bottom of the page and clicking "Save Settings".

{% hint style="success" %}
The form setup and the integration with Payrexx are now complete.
{% endhint %}

## Embedding the Form into Your Website

The following guide explains how to embed the form into your website:

{% embed url="<https://docs.gravityforms.com/category/getting-started/add-form-to-site/>" %}

## Support

If you have any questions about integrating Gravity Forms with Payrexx, our support team will be happy to assist you:

{% content-ref url="/pages/XENk1vjJsqQAqPaejErn" %}
[Payrexx Support Portal](/merchant/english/faq/payrexx-support-portal.md)
{% endcontent-ref %}

If you have questions about creating forms, please refer to the following documentation or contact Gravity Forms support:

{% embed url="<https://docs.gravityforms.com/>" %}

{% embed url="<https://www.gravityforms.com/open-support-ticket/>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payrexx.com/merchant/english/integration/e-commerce/gravity-forms.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
