Quickstart

npm install @lyel/lyel-pay-node

import { LyelPay } from '@lyel/lyel-pay-node';

const lyel = new LyelPay('YOUR_SECRET_KEY');

const intent = await lyel.paymentIntents.create({
  amount: '5000',       // amount in smallest currency unit
  currency: 'XAF',
  description: 'Order #1042 — Boutique Fatou',
  metadata: {
    orderId: '1042',
    customerId: 'cust_abc123',
  },
});

console.log(intent.sessionToken); // pass this to your frontend
console.log(intent.status);       // 'PENDING'

// Express example
app.post('/webhooks/lyelpay', express.raw({ type: 'application/json' }), (req, res) => {
  const signature = req.headers['lyel-signature'] as string;
  
  try {
    const event = lyel.webhooks.constructEvent(
      req.body.toString(),
      signature,
      'YOUR_WEBHOOK_SECRET',
    );

    if (event.type === 'payment.completed') {
      const { paymentIntent } = event.data;
      console.log('Paid:', paymentIntent.id, paymentIntent.amount, paymentIntent.currency);
      // → fulfill the order here
    }

    res.sendStatus(200);
  } catch (err) {
    console.error('Webhook error:', err.message);
    res.sendStatus(400);
  }
});

npm install @lyel/lyel-pay-js

import { LyelPay, OPERATION_TYPE_ENDPOINTS } from '@lyel/lyel-pay-js';

const lyel = new LyelPay({
  apiKey: 'YOUR_API_KEY',
  env: 'production',
});

// Step 1 — Declare the payment
const intention = await lyel.createIntention(OPERATION_TYPE_ENDPOINTS.PAYMENT, {
  amount: 5000,
  from: 'MERCHANT_ID',
  to: 'CLIENT_ID',
  currency: 'XAF',
  description: 'Order #1042',
});

// Step 2 — Send OTP to the paying user
await lyel.initOtp({ userId: 'CLIENT_ID' });

// Step 3 — User enters OTP in your UI, you verify it
await lyel.verifyOtp({ userId: 'CLIENT_ID', otp: userInput });

// Step 4 — Execute
const result = await lyel.charge({ intentionId: intention.id });
console.log('Done ✅', result);

npm install react-lyel-pay-js

import { loadLyelPay, LyelPayElements } from 'react-lyel-pay-js';

const lyelPayPromise = loadLyelPay('YOUR_API_KEY', 5000, 'YOUR_CLIENT_SECRET');

export default function CheckoutPage() {
  return (
    <div>
      <h2>Complete your payment</h2>
      <LyelPayElements options={lyelPayPromise} />
    </div>
  );
}