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. OpenNode facilitates custody and settlement.

OpenNode KYB Required

Before accepting payments in production, you must complete KYB (Know Your Business) 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

How Funds Flow​

Lightning Enable is middleware software - we never touch your funds:

  • You bring your own provider API key (Strike or OpenNode)
  • Your payment provider handles custody, settlement, and compliance
  • Lightning Enable is API middleware only
  • Funds go directly to your provider account
Payment Processing

Lightning Enable does not process payments. Your payment provider (Strike or OpenNode) is a payment software provider and custodian. Consult with legal counsel regarding your specific regulatory obligations.

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:

  • Full REST API access
  • Webhook notifications
  • Refund support
  • Multi-currency pricing
  • Xperience by Kentico integration
  • Shopping cart integration
  • Order management sync
  • Dedicated Kentico support

Your payment provider may charge their own processing fees (paid directly to the provider, not to us).

For API monetization, see Agentic Commerce ($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: "LightningEnable"
);

3. Add Configuration​

// appsettings.json
{
  "LightningEnable": {
    "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 KYB verified
  • OpenNode API key added to Lightning Enable
  • Webhook URL configured
  • HTTPS enabled on your site

Next Steps​

Resources​