Skip to main content

OpenNode Account Setup

Strike is Now Available

Lightning Enable now supports Strike as a payment provider alongside OpenNode. Strike offers preimage support for L402 and instant setup. Set up Strike →

OpenNode is a payment software provider that facilitates Bitcoin custody, settlement, and KYB compliance. Lightning Enable connects to your OpenNode account to create invoices and process payments.

OpenNode KYB Required

You must complete OpenNode's KYB (Know Your Business) verification before accepting live payments. This is required by regulation and cannot be bypassed.

Why OpenNode?​

OpenNode provides:

  • Lightning Network support - Instant Bitcoin payments
  • Automatic conversion - Convert to fiat if desired
  • Bank settlements - Withdraw to your bank account
  • KYB/AML compliance - Regulatory compliance handled for you
  • 24/7 uptime - Enterprise-grade reliability

Lightning Enable uses OpenNode as the underlying payment software provider, giving you:

  • API middleware architecture (we never touch funds - OpenNode facilitates custody and settlement)
  • Bring Your Own API Key (BYOA) model
  • Full control over your payment settings

Create OpenNode Account​

Step 1: Sign Up​

  1. Visit app.opennode.com/signup
  2. Click "Get Started" or "Sign Up"
  3. Enter your email and create a password
  4. Verify your email address

Step 2: Choose Account Type​

Select the appropriate account type:

TypeBest For
IndividualFreelancers, solo developers
BusinessCompanies, e-commerce platforms
EnterpriseHigh-volume merchants, platforms

Step 3: Complete KYB Verification​

OpenNode requires business verification to comply with financial regulations.

Individual Accounts:

  • Government-issued ID (passport, driver's license)
  • Proof of address (utility bill, bank statement)
  • Phone number verification

Business Accounts:

  • Company registration documents
  • Proof of business address
  • Director/owner identification
  • Bank account verification
Verification Time

KYB verification typically takes 2-4 business days. While waiting you can explore OpenNode's development/testnet environment directly — but note that Lightning Enable's hosted platform requires a production OpenNode key, so end-to-end testing starts once KYB completes.

Account Dashboard​

Once verified, your OpenNode dashboard provides:

Overview​

  • Total received payments
  • Pending settlements
  • Account balance
  • Recent transactions

Transactions​

  • Full transaction history
  • Payment details
  • Refund tracking

Settings​

  • API key management
  • Webhook configuration
  • Settlement preferences
  • Security settings

Development vs Production​

OpenNode provides two environments:

Development (Testnet)​

  • URL: dev-api.opennode.com
  • Dashboard: app.dev.opennode.com
  • Bitcoin: Testnet (free test bitcoins)
  • KYB: Not required
  • Use for: Testing and development

Production (Mainnet)​

  • URL: api.opennode.com
  • Dashboard: app.opennode.com
  • Bitcoin: Real mainnet Bitcoin
  • KYB: Required
  • Use for: Live payments
Hosted Platform Uses Production Only

Lightning Enable's hosted platform connects to OpenNode's production API — development-environment keys cannot be used with it. The dev environment is useful for exploring OpenNode's own API on testnet, but to test your Lightning Enable integration, use a production key and a small real payment. See Testing.

Account Security​

Enable Two-Factor Authentication​

  1. Go to Settings > Security
  2. Click Enable 2FA
  3. Scan QR code with authenticator app
  4. Enter verification code
  5. Save backup codes securely

API Key Security​

  • Never share your API keys
  • Store any copy in a password manager or secret store — the key itself lives encrypted in Lightning Enable once you save it in the dashboard
  • Rotate keys periodically

IP Allowlisting​

OpenNode lets you restrict API access by source IP (Settings > Security). Do not enable this for the key you use with Lightning Enable: API calls to OpenNode come from Lightning Enable's hosted platform, whose outbound IP addresses are not static, so an IP allowlist would intermittently break payments.

Settlement Configuration​

Bitcoin Holdings​

Keep received payments in Bitcoin:

  1. Go to Settings > Settlement
  2. Select "Keep in Bitcoin"
  3. Withdraw manually when desired

Auto-Convert to Fiat​

Automatically convert to USD/EUR:

  1. Go to Settings > Settlement
  2. Select "Convert to Fiat"
  3. Choose your currency
  4. Set conversion percentage (0-100%)

Bank Settlements​

Receive fiat to your bank account:

  1. Complete business verification
  2. Add bank account details
  3. Set settlement frequency (daily, weekly)
  4. Configure minimum settlement amount

Troubleshooting​

Account Verification Pending​

If verification is taking longer than expected:

  1. Check email for requests for additional documents
  2. Ensure all documents are clear and readable
  3. Contact OpenNode support

Account Locked​

If your account is locked:

  1. Check email for explanation
  2. Respond to any compliance requests
  3. Contact support@opennode.com

Test Payments Not Working​

If test payments through Lightning Enable are failing:

  1. Confirm your OpenNode key is a production key from app.opennode.com (dev keys don't work with the hosted platform)
  2. Validate the key: POST /api/merchant/validate-opennode with your merchant API key
  3. Check your OpenNode account is active and KYB-verified
  4. See Testing for the full walkthrough

Next Steps​

Once your OpenNode account is set up:

  • API Keys - Generate and configure API keys
  • Webhooks - Set up payment notifications
  • Testing - Test your integration