Skip to main content

Setup

Step 1 — Create a Coinsnap account​

  1. Go to app.coinsnap.io and create an account
  2. Complete store setup — add your store name and configure your payout wallet address
  3. Your store is now ready to accept payments

Step 2 — Get your API credentials​

  1. In the Coinsnap dashboard, go to Settings → Store
  2. Scroll to the API Keys section, enter a label (e.g. WordPress Production), and click Create API key
  3. Copy the API key — it is only shown once
  4. Note your Store ID — visible on the same page and in the URL

You will need both values for the plugin configuration.

Step 3 — Install the plugin​

From WordPress plugin directory​

Search for "Coinsnap" in Plugins → Add New in your WordPress admin. Install and activate directly from the WordPress.org plugin directory.

From GitHub​

  1. Download the latest release ZIP from the plugin's GitHub repository (see Overview for links)
  2. In your WordPress admin, go to Plugins → Add New → Upload Plugin
  3. Upload the ZIP file and click Install Now
  4. Click Activate

Step 4 — Configure the plugin​

WooCommerce​

  1. Go to WooCommerce → Settings → Payments
  2. Find Coinsnap Bitcoin + Lightning and click Manage
  3. Enter your Store ID and API Key
  4. Set the payment gateway title and description (shown to customers at checkout)
  5. Click Save changes

Other plugins​

Configuration for GiveWP, Ninja Forms, Easy Digital Downloads, and other plugins follows the same pattern: install the plugin, then navigate to the plugin's payment settings and enter your Store ID and API Key. The specific menu path varies by plugin.

Step 5 — Test a payment​

  1. Place a test order on your site and select the Coinsnap payment method
  2. You should be redirected to the Coinsnap-hosted payment page
  3. Use a test Lightning wallet (e.g. Phoenix in testnet mode) to pay
  4. Verify the order status updates to Paid in WordPress

For testing, use a Lightning wallet in testnet or regtest mode (e.g. Phoenix, Breez, or Mutiny) and a Coinsnap test store if available in your account.

Troubleshooting​

ProblemCheck
Payment option not showing at checkoutPlugin is activated; API credentials are saved
Redirect fails or shows errorStore ID and API key are correct; no trailing spaces
Order status doesn't update after paymentWebhook is configured — see Webhooks
SSL errorYour WordPress site must use HTTPS in production