Coinsnap for WPForms Installation Guide

These requirements must be met for Coinsnap for WPForms to function correctly:

WordPress & WPForms

• A self-hosted WordPress website
• WPForms 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 WPForms 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

WPForms Setup

• At least one WPForms 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 WPForms —
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 WPForms plugin.

WPForms Coinsnap Settings

Go to WPForms / All Forms [1] in the black sidebar on the left.
Then choose a form in which you want to implement Bitcoin-Lightning payment and click on edit [2].

You will now see this screen:

In the next screen, click on Coinsnap to open the configuration page for the Coinsnap plugin:

There are eight options you need to configure now. We’ll now walk you through each one step by step—and explain what it does and why it matters.

1. Enable Bitcoin payments

Check the box to enable Bitcoin payments for this form.

2. Choose and set up your payment provider

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

3. 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.

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.

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

4. 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.

5. WPForms  payment statuses

WPForms tracks the status of each payment associated with a form submission. These statuses indicate whether a payment is pending, completed, or failed and help you understand the current state of each transaction.

Coinsnap recommends using the default settings. However, if you choose to configure them differently, the following explains how to map the payment statuses available in Coinsnap to the corresponding payment statuses in WPForms.

5a. Expired status

You can now select the submission status as Processed, Completed, Pending, Failed, Refunded, or Partially Refunded from the dropdown, depending on the outcome of the transaction.

5b. Settled Status

You have the same choices as with the Expired Status.

5c. Processing Status

You have the same choices as before.

Done – start accepting Bitcoin payments in your WPForms

If you have enabled Coinsnap payments and completed all required fields as described above, a payment field will appear in your form where you can enter the amount. A button at the bottom of the form then launches the payment interface. This opens a QR code that the customer scans with their Lightning wallet to authorize the payment. The payment is credited directly to your Lightning wallet.

After all settings have been completed, you should carry out a test transaction. Fill out a WPForm that has Bitcoin payments enabled and click the blue button to start the Bitcoin payment process.

After the successful payment, the invoice can be viewed in detail: