TypeScript SDK

import { LomiSDK } from '@lomi./sdk';

const lomi = new LomiSDK({
  apiKey: process.env.LOMI_SECRET_KEY!,
  environment: 'live', // 'test' for sandbox, 'live' for production
});

const session = await lomi.checkoutSessions.create({
  amount: 10000,
  currency_code: 'XOF',
  title: 'Premium Subscription',
  description: 'Monthly access to premium features',
  customer_email: 'customer@example.com',
  success_url: 'https://yoursite.com/success',
  cancel_url: 'https://yoursite.com/cancel',
  metadata: { order_id: 'ORD-123' },
});

console.log('Redirect to:', session.checkout_url);

const link = await lomi.paymentLinks.create({
  link_type: 'product',
  title: 'Pro Plan',
  currency_code: 'XOF',
  product_id: 'prod_abc123...',
  allow_coupon_code: true,
});

console.log('Share this link:', link.url);

const transactions = await lomi.transactions.list({
  status: 'completed',
  provider: 'WAVE',
  startDate: '2024-01-01T00:00:00Z',
  pageSize: 50,
});

for (const tx of transactions) {
  console.log(`${tx.id}: ${tx.gross_amount} ${tx.currency_code}`);
}

const customer = await lomi.customers.create({
  name: 'Amadou Ba',
  email: 'amadou@example.com',
  phone_number: '+221771234567',
  country: 'Senegal',
  city: 'Dakar',
  metadata: { source: 'website' },
});

console.log('Customer ID:', customer.id);

const transactions = await lomi.customers.getTransactions('cus_abc123...');

const product = await lomi.products.create({
  name: 'Premium Plan',
  description: 'Full access to all features',
  product_type: 'recurring',
  prices: [
    {
      amount: 15000,
      currency_code: 'XOF',
      billing_interval: 'month',
      is_default: true,
    },
  ],
  trial_enabled: true,
  trial_period_days: 7,
});

const price = await lomi.products.addPrice('prod_abc123...', {
  amount: 150000,
  currency_code: 'XOF',
  billing_interval: 'year',
});

const cancelled = await lomi.subscriptions.cancel('sub_abc123...', {
  cancel_at_period_end: true,
  reason: 'Customer request',
});

const payout = await lomi.payouts.create({
  amount: 100000,
  currency_code: 'XOF',
  payout_method_id: 'pm_abc123...',
  description: 'Monthly withdrawal',
});

const beneficiaryPayout = await lomi.beneficiaryPayouts.create({
  amount: 50000,
  currency_code: 'XOF',
  beneficiary_phone: '+221771234567',
  beneficiary_name: 'Contractor Name',
  provider_code: 'WAVE',
});

const balances = await lomi.accounts.getBalance();
const xofBalance = await lomi.accounts.getBalance({ currency: 'XOF' });

console.log('Available:', xofBalance.available);

const metrics = await lomi.organizations.getMetrics();

console.log('MRR:', metrics.mrr);
console.log('Total Customers:', metrics.total_customers);

import { LomiSDK, LomiError, LomiNotFoundError } from '@lomi./sdk';

try {
  const customer = await lomi.customers.get('invalid_id');
} catch (error) {
  if (error instanceof LomiNotFoundError) {
    console.error('Customer not found');
  } else if (error instanceof LomiError) {
    console.error(`API Error [${error.status}]: ${error.message}`);
  } else {
    throw error;
  }
}

interface LomiConfig {
  apiKey: string;              // Your secret API key
  environment?: 'test' | 'live'; // Sandbox or production
  baseUrl?: string;            // Custom base URL (overrides environment)
  headers?: Record<string, string>; // Additional request headers
  timeout?: number;            // Request timeout in ms (default: 30000)
}

import type {
  LomiConfig,
  Customer,
  CustomerCreate,
  CheckoutSession,
  CheckoutSessionCreate,
  Transaction,
  Product,
  ProductCreate,
  Subscription,
  PaymentLink,
} from '@lomi./sdk';