Skip to main content

Kentico Commerce Integration

Lightning Enable provides a complete payment gateway integration for Xperience by Kentico e-commerce sites, enabling Bitcoin Lightning payments without custody or money transmission concerns.

OpenNode KYC Required

Before accepting payments in production, you must complete KYC verification with OpenNode. This is a regulatory requirement for processing real payments. Learn more

What You Get​

A turnkey payment gateway for Kentico Commerce:

  • Full IPaymentGateway implementation compatible with XperienceCommunity.Commerce
  • Lightning checkout UI with Apple-style accordion interface
  • Razor Pages for payment flow (checkout, success, cancel)
  • Real-time payment status polling with server-side caching
  • Webhook integration with HMAC signature verification
  • Express checkout button component
  • Automatic order processing on payment confirmation

Target Platform​

RequirementVersion
Xperience by Kentico31.0.1+
.NET9.0
Commerce PackageXperienceCommunity.Commerce.PaymentProviders.Core

How It Works​

+-----------------------------+
|  Xperience by Kentico Site  |
|                             |
|  +---------------------+    |
|  | Shopping Cart       |    |
|  +----------+----------+    |
|             |               |
|             v               |
|  +---------------------+    |
|  | LightningPayment    |    |
|  |    Gateway          |----+----> Lightning Enable API
|  | (IPaymentGateway)   |    |              |
|  +---------------------+    |              v
|             |               |        OpenNode (Your Account)
|             v               |              |
|  +---------------------+    |              v
|  | Lightning Checkout  |    |        Customer's Wallet
|  |  (Razor Page)       |    |
|  +---------------------+    |
+-----------------------------+
  1. Customer adds items to cart and proceeds to checkout
  2. Customer selects "Bitcoin Lightning" as payment method
  3. LightningPaymentGateway creates a payment via Lightning Enable API
  4. Customer redirected to Lightning checkout page with QR code
  5. Customer pays using any Lightning wallet
  6. Webhook notification confirms payment
  7. Order marked as paid in Kentico admin
  8. Customer redirected to order confirmation

Non-Custodial Architecture​

Lightning Enable never touches your funds:

  • You bring your own OpenNode API key
  • OpenNode handles custody, settlement, and compliance
  • Lightning Enable is middleware only - API forwarding
  • Funds go directly to your OpenNode account

This means you're not a money transmitter and don't need financial licenses.

Key Features​

Apple-Style Checkout​

Premium checkout experience with:

  • Collapsible accordion sections
  • Real-time payment status updates
  • Mobile-optimized QR codes
  • Copy-to-clipboard for invoices

Payment Options​

Every checkout includes:

  • Lightning Network - Instant, near-zero fees
  • On-chain Bitcoin - Traditional Bitcoin payment
  • Hosted Checkout - OpenNode's hosted page

Automatic Order Processing​

When payment is confirmed:

  1. Webhook fires to your site
  2. Order status updates to "Paid"
  3. Inventory adjusted
  4. Confirmation email sent
  5. Fulfillment workflow triggered

Real-Time Status Updates​

Two modes for detecting payments:

  • Webhooks (production) - Instant HTTP callbacks
  • Polling (fallback) - Periodic status checks

Pricing​

Kentico Commerce: $249/month

Includes everything in Standalone API plus:

  • Xperience by Kentico integration
  • Shopping cart integration
  • Order management sync
  • Dedicated Kentico support

OpenNode charges 1% per transaction for payment processing (paid directly to OpenNode).

For standalone REST API, see Standalone API ($199/mo). For API monetization, see L402 Microtransactions ($299/mo).

Quick Start​

1. Install NuGet Package​

dotnet add package LightningEnable.Kentico

2. Configure Services​

// Program.cs
using LightningEnable.Kentico.Extensions;

builder.Services.AddLightningPaymentGatewayFromConfiguration(
    builder.Configuration,
    configurationSectionPath: "LightningGateway"
);

3. Add Configuration​

// appsettings.json
{
  "LightningGateway": {
    "ApiBaseUrl": "https://api.lightningenable.com",
    "ApiKey": "le_merchant_your-api-key",
    "WebhookSecret": "your-webhook-secret"
  }
}

4. Done!​

Lightning payment is now available as a payment option in your Kentico store.

Demo​

See Lightning payments in action:

  1. Add a product to cart
  2. Proceed to checkout
  3. Select "Bitcoin Lightning Network" payment
  4. Scan QR code with any Lightning wallet
  5. Payment confirms in ~1 second

Requirements​

Before integration:

  • Lightning Enable subscription active
  • OpenNode account with KYC verified
  • OpenNode API key added to Lightning Enable
  • Webhook URL configured
  • HTTPS enabled on your site

Next Steps​

Resources​