WP Manifestindependent plugin directory
manifest / ecommerce / plugin-memberpress

NakoPay for MemberPress

NakoPay plugin for memberpress

★ 0stars
v0.3.1latest · 5mo ago

Install

Download nakopay-memberpress.zip From the v0.3.1 release on GitHub, May 28, 2026

Upload it under Plugins → Add New Plugin → Upload Plugin, then activate.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/nakopayhq/plugin-memberpress/releases/download/v0.3.1/nakopay-memberpress.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Accept Bitcoin and crypto payments for MemberPress memberships, courses, and subscriptions. Non-custodial, wallet-to-wallet - NakoPay never holds your funds.

Requirements

  • WordPress 6.0+
  • MemberPress 1.9+
  • PHP 8.0+
  • A NakoPay account (sign up free)

Install

Option A: Upload zip (recommended)

  1. Download nakopay-memberpress.zip from the latest release
  2. In wp-admin: Plugins > Add New > Upload Plugin > Choose File > pick the zip > Install Now > Activate

Option B: Clone from GitHub

cd wp-content/plugins
git clone https://github.com/NakoPayHQ/plugin-memberpress.git nakopay-memberpress

Activate in wp-admin: Plugins > Installed Plugins > NakoPay for MemberPress > Activate

Configure

  1. Get your API key at nakopay.com/dashboard/api-keys
  2. In wp-admin: MemberPress > Settings > Payments tab
  3. Click Add Payment Method (or the + button)
  4. Select NakoPay (Bitcoin) from the Gateway dropdown
  5. Paste your Secret key (sk_test_* or sk_live_*) in the API Key field
  6. Paste your Webhook Signing Secret (whsec_*) in the Webhook Secret field
  7. Click Update Options

Webhook URL

Set this URL in your NakoPay dashboard at nakopay.com/dashboard/webhooks:

https://your-site.com/?mepr-listener=nakopay

Subscribe to events: invoice.paid, invoice.expired

Test mode

Use sk_test_* keys to test the full checkout flow without real funds. Flip to sk_live_* when you're ready for production.

How it works

  1. Member selects a membership and chooses "NakoPay (Bitcoin)" as payment method
  2. Plugin creates a NakoPay invoice via the API
  3. Member is redirected to NakoPay's hosted checkout page (QR code + pay address)
  4. On payment confirmation, NakoPay sends a webhook to your site
  5. Plugin verifies the HMAC-SHA256 signature and activates the membership
  6. Member gets immediate access to protected content

Supported features

  • [x] One-time membership payments
  • [x] Hosted checkout (redirect)
  • [x] HMAC-SHA256 webhook verification
  • [x] Test/live mode toggle
  • [x] Transaction ID storage
  • [x] Automatic membership activation
  • [x] Admin settings panel
  • [ ] Recurring subscription renewals (planned)

Troubleshooting

NakoPay doesn't appear in the gateway dropdown

  • Make sure MemberPress is installed and active before activating NakoPay for MemberPress
  • Deactivate and reactivate the NakoPay plugin

Membership doesn't activate after payment

  1. Check the webhook URL in nakopay.com/dashboard/webhooks matches your domain
  2. Re-paste the whsec_* secret (don't retype)
  3. Resend the webhook from the dashboard

"NakoPay error" on checkout

  • Verify your API key is valid at nakopay.com/dashboard/api-keys
  • Check that the API key starts with sk_test_ or sk_live_

Support

About MemberPress

MemberPress - WordPress membership plugin for subscriptions, courses, and paywalls. Visit their website to learn more about the platform and its features.

License

MIT

Subscription Webhooks

NakoPay supports recurring crypto subscriptions. When enabled, your webhook endpoint receives these additional events:

Event Description
subscription.created New subscription activated
subscription.renewed Renewal invoice generated, billing period advanced
subscription.past_due Payment overdue (3-day grace period expired)
subscription.updated Subscription details changed
subscription.canceled Subscription ended (manual cancel or non-payment after 7 days past due)

Each event payload includes the subscription id, amount, coin, interval, status, and metadata (plan name, plan ID). Renewal and past-due events also include the invoice_id.

To enable subscription webhooks, add subscription.* to your webhook endpoint's enabled events in your NakoPay dashboard at nakopay.com/dashboard/settings.

Releases

2 releases. Each count is every asset in that release; expand a row for the breakdown.

Tag
Published
Assets
Downloads
v0.3.1 latest
May 28, 2026 5mo ago
nakopay-memberpress.zip
0
May 2, 2026 6mo ago
tag only
—