Coinsnap for Gravity Forms Installation Guide

These requirements must be met for Coinsnap for Gravity Forms to function correctly:

WordPress & Gravity Forms

• A self-hosted WordPress website
• Gravity Forms installed and activated

Coinsnap & Payments

• An active Coinsnap account
  -> how to set up a Coinsnap account
• A connected Bitcoin Lightning wallet (self-custodial wallet or BTCPay Server)
  -> how to get a Lightning address
• The installed Coinsnap for Gravity Forms plugin
  -> How to install the plugin and connect it with your Coinsnap account or your BTCPay Server

Server & Access

• Ability to install and activate WordPress plugins
• HTTPS (SSL) enabled on the website

Gravity Forms Setup

• At least one Gravity Forms form created

All the requirements listed above are met, and you have successfully installed the plugin in your WordPress.
If not, here is a Step-by-step: How to install a Coinsnap plugin in WordPress guide to help you install the plugin.

You will soon be able to accept Bitcoin payments (on-chain and Lightning) directly from within your Gravity Forms —
without the need for a complex shop system like WooCommerce or traditional payment providers such as credit cards or PayPal.

But before you can do that, you need to configure Bitcoin payments in your Gravity Forms plugin.

Gravity Forms Coinsnap Settings

Go to Gravity Forms / Settings [1] in the black sidebar on the left. Then click Coinsnap [2].

You will then see this screen:

You will now need to configure three parameters: your chosen payment provider (Coinsnap or your BTCPay Server), the after-payment redirect page URL, and the mapping of payment statuses (Expired, Settled, Processing).

The following steps show you how to set everything up correctly:

1. Choose and set up your payment provider

You now need to choose between two payment gateways: Coinsnap or your own BTCPay Server.

2. Connect your plugin to your chosen payment provider

After making your selection, enter the corresponding Store ID and API Key for either Coinsnap or BTCPay Server. The following steps explain how to do this.

Coinsnap

Coinsnap is the easiest option. Coinsnap handles the technical setup for you and connects your store to Bitcoin and Lightning payments with just a few clicks. It’s ideal if you want a quick, hassle-free solution without managing your own payment infrastructure.

Just enter your Coinsnap Store ID and API Key.

Learn here how to retrieve your Coinsnap Store ID and API Key:

-> Step-by-step explanation: How to connect your Coinsnap account with your plugin

BTCPay Server

BTCPay Server is a self-hosted option for merchants who want full control. You run your own Bitcoin and Lightning payment server, manage your own wallets, and don’t rely on a third party. This option offers maximum independence but requires more technical setup and maintenance.

First, enter your BTCPay Server URL. Then enter the corresponding BTCPay Server Store ID and API Key.

Learn how to retrieve your Store ID and API Key using our BTCPay Server wizard here:

-> Step-by-step explanation: How to connect your BTCPay Server with your plugin 

3. Redirect after payment and Return URL after payment

Here you define what happens after a successful payment. If Redirect after payment is enabled, the customer will be redirected back to the page containing the form from which the payment was made.

If you prefer to use a custom thank-you page, create the page and enter its URL in the Return URL after payment field.

4. Gravity Forms  payment statuses

Gravity Forms tracks the status of each payment associated with a form submission. These statuses indicate whether a payment is Authorized, Paid, Processing, Failed, Active, Cancelled, Pending, Refunded, or Voided and help you understand the current state of each transaction.

The Coinsnap Bitcoin payment plugin only tracks three payment statuses — Expired, Settled, and Processing. You now need to map each of these to the corresponding status option available in Gravity Forms.

We strongly recommend keeping the default payment status mapping, as it provides the most reliable and consistent behavior in almost all cases; selecting an alternative option from the dropdown should only be done in very specific, exceptional circumstances.

DONE

Save these settings by clicking the button below, and your Gravity Form will be ready to accept Bitcoin payments (on-chain and Lightning).

In the next step, we’ll show you how to integrate Bitcoin payments directly into any of your Gravity Forms.

Create a payment form

First set up a form (i.e. a Bitcoin donation form) in Gravity forms. As soon as you are done, click on Settings on the top and choose Coinsnap.

Add the Coinsnap payment gateway to your form

After you clicked on Coinsnap [1], you now have to add a Coinsnap feed to your form, simply by clicking on add new [2].

You will then see this window. We recommend not changing any of the parameters. However, if needed, you can adjust the name, transaction type, or payment amount using the respective fields. Click Save when you are done.

Start receiving Bitcoin in your new donation form

If you now open the forms overview in Gravity Forms, you will notice that your plugin Donation Form Setup  is now active – meaning that Bitcoin payment now works in the plugin.

Now, in the form you want to use on your website, click on </> Embed on the top right of your form [1].

Next, either copy the Form ID [2] or the shortcode [3] and place it at the appropriate place of your website.

And your visitors can now donate sats to your cause!

After all settings have been made, a test transaction should be carried out.

Fill out a Gravity Form you have just created and click on the blue button, starting the Bitcoin payment.

You will now be redirected to the Bitcoin payment page to complete the purchase.

The Bitcoin payment page is now displayed and offers the payer the option of paying with Bitcoin or Lightning. Both methods are integrated in the displayed QR code.

If the payment was successful, your customer will see a confirmation page similar to this.

After a successful payment, the invoice can be viewed in detail.

Go to Forms, select the form you just received a payment from, and click on Edit.

In the form, click on Entries at the top, and you will see all payments that have been made through this form.