Skip to main content

Prerequisites

Before you begin integrating Lightning Enable, ensure you have the following ready.

OpenNode KYC Required

You must complete OpenNode KYC verification before you can accept payments. This is a regulatory requirement and cannot be bypassed. Plan for 1-3 business days for verification.

Required​

1. OpenNode Account​

You need an OpenNode account with a verified API key.

EnvironmentURLPurpose
Testnet (Development)dev.opennode.comTesting with fake Bitcoin
Mainnet (Production)app.opennode.comReal payments

Steps:

  1. Sign up at OpenNode
  2. Complete KYC verification (required for mainnet)
  3. Generate an API key
  4. Store the API key securely

Detailed OpenNode Setup Guide

2. Lightning Enable Subscription​

Subscribe to Lightning Enable to get your merchant API key.

Available Plans:

PlanMonthlyMerchantsBest For
Pilot$491Evaluation and testing
Production$19910Multi-merchant production
Platform$499UnlimitedEnterprise scale

After subscribing, you'll receive:

  • Your Lightning Enable API key
  • Access to the merchant dashboard
  • Webhook configuration options

3. Development Environment​

Any platform that can make HTTP REST API calls:

Recommended:

  • .NET 9 / ASP.NET Core
  • Node.js / TypeScript
  • Python
  • Any language with HTTP client support

Technical Requirements:

  • HTTPS support (required for webhooks)
  • Ability to store API keys securely
  • JSON parsing capability

Webhook Endpoint​

For production use, webhooks provide instant payment notifications:

  • Public HTTPS URL (not localhost)
  • Ability to validate HMAC signatures
  • Idempotent processing (webhooks may retry)

For local development, use ngrok to expose your local server.

Database​

To track payments and orders:

  • SQL Server (recommended for .NET)
  • PostgreSQL
  • MySQL
  • Any relational database

SSL/TLS Certificate​

Required for:

  • Webhook verification
  • API security
  • Production deployment

Platform-Specific Requirements​

For Kentico Commerce​

If you're integrating with Xperience by Kentico:

  • Xperience by Kentico 31.0.1 or later
  • XperienceCommunity.Commerce package installed
  • .NET 9 SDK
  • Visual Studio 2022+ or VS Code

For L402 Microtransactions​

If you're implementing L402 API monetization:

  • Production OpenNode key (mainnet payments required)
  • Public API endpoint to protect
  • Understanding of macaroons (bearer tokens)

Environment Checklist​

Use this checklist before starting integration:

Development​

  • OpenNode testnet account created
  • Testnet API key generated
  • Lightning Enable subscription active
  • Merchant API key received
  • Development environment ready
  • ngrok installed (for webhook testing)

Production​

  • OpenNode mainnet account created
  • KYC verification completed
  • Mainnet API key generated
  • Production Lightning Enable API key configured
  • Webhook endpoint deployed and accessible
  • HTTPS configured
  • API keys stored securely (not in code)
  • Error logging and monitoring enabled

Next Steps​

Once you have all prerequisites:

  1. Quick Start Guide - Create your first payment
  2. OpenNode Setup - Detailed OpenNode configuration
  3. Choose your product: