Getting started

# Replace with your actual Test Secret Key from the lomi. dashboard
export LOMI_API_KEY=lomi_sk_test_xxxxxxxxxxxxxxxxxxxxxx
# or
# Set the API Key directly for production.
export LOMI_API_KEY=lomi_sk_live_xxxxxxxxxxxxxxxxxxxxxx

export LOMI_API_URL=https://sandbox.api.lomi.africa/v1
# or
export LOMI_API_URL=https://api.lomi.africa/v1

bun install lomi.cli
# or
npm install lomi.cli

import { LomiSDK } from 'lomi.cli';
 
// Initialize the SDK using environment variables
const lomi = new LomiSDK({
  apiKey: process.env.LOMI_API_KEY,
  baseUrl: process.env.LOMI_API_URL // Uses the sandbox URL from env var
});
 
async function getMerchantDetails(merchantId: string) {
  if (!process.env.LOMI_API_KEY || !process.env.LOMI_API_URL) {
    console.error('Error: LOMI_API_KEY and LOMI_API_URL environment variables must be set.');
    return;
  }
  if (!merchantId || merchantId === 'YOUR_MERCHANT_ID') {
     console.error('Error: Please replace "YOUR_MERCHANT_ID" with your actual Merchant ID from the lomi. dashboard.');
     return;
  }
 
  try {
    console.log(`Retrieving details for merchant: ${merchantId}...`);
    const merchant = await lomi.merchants.get(merchantId);
    console.log('Successfully retrieved merchant details:');
    console.log(JSON.stringify(merchant, null, 2)); // Pretty print the JSON response
 
    /* Expected Output Structure:
    {
      "data": {
        "merchant_id": "d463e162-c632-4428-a39f-22bf76793340", // Example value, will return actual merchant id
        "name": "The African Ledger",
        "email": "paul@africanledger.com,
        "phone_number": "+2250160223401,
        "country": "CI", // e.g., Côte d'Ivoire
        "mrr": 0, // Example value, will reflect actual MRR
        "arr": 0, // Example value, will reflect actual ARR
        "metadata": {
          // Any metadata associated with the merchant
        },
        "created_at": "2023-10-26T10:00:00Z", // Example timestamp
        "updated_at": "2023-10-26T10:00:00Z" // Example timestamp
      }
    }
    */
 
  } catch (error) {
    console.error('Failed to retrieve merchant details:', error);
  }
}
 
// --- How to run this example ---
// 1. Save the code above as a .ts file (e.g., getMerchant.ts).
// 2. Make sure you have Node.js and ts-node installed (`npm install -g typescript ts-node`).
// 3. Set your environment variables (LOMI_API_KEY, LOMI_API_URL) as shown in Step 2.
// 4. Get your Merchant ID from the lomi. dashboard.
// 5. Run the script: ts-node getMerchant.ts YOUR_MERCHANT_ID
// Example: ts-node getMerchant.ts d463e263-c612-4428-a39f-22bf76793340
 
// Example usage (replace with your actual Merchant ID):
getMerchantDetails('YOUR_MERCHANT_ID');

# Make sure env vars are set:
# export LOMI_API_KEY=lomi_sk_test_...
# export LOMI_API_URL=https://sandbox.api.lomi.africa/v1
 
# Replace YOUR_MERCHANT_ID with your actual Merchant ID
export MERCHANT_ID=YOUR_MERCHANT_ID
 
# Check if MERCHANT_ID is set and not the placeholder
if [ -z "$MERCHANT_ID" ] || [ "$MERCHANT_ID" = "YOUR_MERCHANT_ID" ]; then
  echo "Error: Please set the MERCHANT_ID environment variable with your actual Merchant ID."
else
  echo "Attempting to retrieve details for merchant: $MERCHANT_ID using $LOMI_API_URL ..."
  curl -X GET "${LOMI_API_URL}/merchants/${MERCHANT_ID}" \
    -H "X-API-Key: ${LOMI_API_KEY}" | jq .
fi
 

import express from 'express';
import { LomiSDK } from 'lomi.cli'; // Assuming LomiSDK is correctly imported
 
const app = express();
 
// Use JSON middleware, but ensure raw body is captured for signature verification
// lomi. sends webhooks as POST requests with a JSON payload.
app.use(express.json({
  verify: (req: any, res, buf) => { // Add type 'any' or define interface for req
    req.rawBody = buf; // Store the raw buffer for signature verification
  }
}));
 
// Initialize lomi. SDK (only needed for signature verification here)
// Ensure API Key is set if verifySignature needs it, otherwise it might just need the secret.
// Double-check if LomiSDK instance is needed or if verifySignature is static/standalone.
// Assuming verifySignature is available on an instance or statically:
const lomi = new LomiSDK({ apiKey: process.env.LOMI_API_KEY }); // May not be needed if secret is passed directly
 
app.post('/webhook', (req: any, res) => { // Add type 'any' or define interface for req
  const signature = req.headers['x-lomi-signature'] as string; // Get signature from header
  const secret = process.env.LOMI_WEBHOOK_SECRET; // Get your webhook secret from env var
 
  if (!secret) {
    console.error('Webhook secret is not configured in environment variables (LOMI_WEBHOOK_SECRET).');
    return res.status(500).send('Webhook secret not configured.');
  }
  if (!signature) {
    console.warn('Webhook request received without x-lomi-signature header.');
    return res.status(400).send('Missing signature.');
  }
  if (!req.rawBody) {
     console.error('Raw body buffer not available for signature verification.');
     return res.status(500).send('Internal server error during webhook processing.');
  }
 
  let isValid = false;
  try {
    // Verify the signature using the raw body buffer, the received signature, and your secret
    isValid = lomi.webhooks.verifySignature(
      req.rawBody,
      signature,
      secret
    );
  } catch (error) {
      console.error('Error during webhook signature verification:', error);
      return res.status(500).send('Error verifying webhook signature.');
  }
 
 
  if (!isValid) {
    console.error('Invalid webhook signature received.');
    return res.status(400).send('Invalid signature.');
  }
 
  // Signature is valid, proceed to handle the event
  const event = req.body; // Use the parsed JSON body
  console.log(`Webhook received and verified: ${event.type}`);
 
  // Handle different event types
  switch (event.type) {
    // See Webhooks API docs for a full list of event types
    case 'PAYMENT_SUCCEEDED':
      console.log('Payment succeeded!', event.data);
      // TODO: Implement logic for successful payment (e.g., update order status, grant access)
      break;
    case 'CHECKOUT_COMPLETED':
      console.log('Checkout completed!', event.data);
      // TODO: Implement logic for completed checkout
      break;
    case 'SUBSCRIPTION_RENEWED':
      console.log('Subscription renewed!', event.data);
      // TODO: Implement logic for subscription renewal
      break;
    case 'PAYMENT_FAILED':
      console.log('Payment failed.', event.data);
      // TODO: Implement logic for failed payment (e.g., notify customer)
      break;
    // Add cases for other relevant events like:
    // case 'CUSTOMER_CREATED':
    // case 'SUBSCRIPTION_CANCELED':
    // etc.
    default:
      console.log(`Unhandled event type: ${event.type}`);
  }
 
  // Acknowledge receipt of the webhook
  res.status(200).json({ received: true });
});
 
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => console.log(`Webhook listener running on port ${PORT}`));