Integration Tutorials & Best Practices

// Complete Lightning integration example
const express = require('express');
const { createInvoice, getInvoice } = require('lightning-client');

const app = express();
app.use(express.json());

// Create payment endpoint
app.post('/api/payment/lightning', async (req, res) => {
    try {
        const { amount, memo, callback_url } = req.body;
        
        // Create Lightning invoice
        const invoice = await createInvoice({
            value: amount * 100000000, // Convert to satoshis
            memo: memo || 'Payment',
            expiry: 1800, // 30 minutes
            private: false
        });
        
        // Store invoice in database with order ID
        await db.invoices.create({
            payment_hash: invoice.payment_hash,
            payment_request: invoice.payment_request,
            amount: amount,
            status: 'pending',
            callback_url
        });
        
        res.json({
            success: true,
            invoice: invoice.payment_request,
            expires_at: new Date(Date.now() + 1800000)
        });
        
    } catch (error) {
        console.error('Invoice creation failed:', error);
        res.status(500).json({ error: 'Payment system unavailable' });
    }
});

// Webhook for payment confirmation
app.post('/api/webhooks/lightning', async (req, res) => {
    const { payment_hash, sat, status } = req.body;
    
    if (status === 'paid') {
        // Update order status
        await db.invoices.update(
            { payment_hash },
            { status: 'completed', paid_at: new Date() }
        );
        
        // Trigger order fulfillment
        await fulfillOrder(payment_hash);
    }
    
    res.status(200).send('OK');
});