npm install @sahelpay/sdk

import SahelPay from '@sahelpay/sdk';

const sahelpay = new SahelPay({
  secretKey: process.env.SAHELPAY_SECRET_KEY!, // sk_test_... ou sk_live_...
  // baseUrl: 'https://api.sahelpay.ml', // défaut, identique en sandbox et en production
});

const payment = await sahelpay.payments.create({
  amount: 5000,
  currency: 'XOF',
  payment_method: 'ORANGE_MONEY', // seul moyen de paiement
  customer_phone: '+22370123456', // facultatif avec le checkout hébergé
  description: 'Commande #123',
  client_reference: 'order-123',
  return_url: 'https://votre-site.com/checkout/return?order=order-123',
  idempotency_key: 'order-123', // recommandé ; généré automatiquement sinon
});

// Renvoyer l'URL au frontend pour rediriger le client
return { url: payment.redirect_url };

const payment = await sahelpay.payments.create({
  amount: 4000,
  payment_method: 'ORANGE_MONEY',
  customer_phone: '+22370123456',
  hosted_checkout: false, // la simulation démarre à l'initiation
  mock: true,
});

const result = await sahelpay.payments.checkStatus(payment.id);
console.log(result.status); // SUCCESS

await sahelpay.webhooks.test(); // envoie webhook.test vers votre endpoint configuré

const result = await sahelpay.payments.checkStatus(payment.id);
console.log(result.status); // 'INITIATED' | 'PENDING' | 'SUCCESS' | 'FAILED' | 'EXPIRED'

const byOrder = await sahelpay.payments.search('order-123'); // null si introuvable

await sahelpay.payments.expire(payment.id); // paiement non terminal dont expires_at est dépassé

const link = await sahelpay.paymentLinks.create({
  name: 'Abonnement Premium',
  fixed_amount: 10000, // prix imposé : le SDK envoie amount_mode FIXED
  success_redirect_url: 'https://votre-site.com/merci',
});
console.log(link.url); // https://pay.sahelpay.africa/<slug>

await sahelpay.paymentLinks.update(link.id, { name: 'Premium (octobre)' });
await sahelpay.paymentLinks.deactivate(link.id);
await sahelpay.paymentLinks.delete(link.id); // archivage définitif

const { logs } = await sahelpay.webhooks.listLogs({ status: 'FAILED', limit: 20 });
for (const log of logs) await sahelpay.webhooks.retry(log.id);

const order = await sahelpay.secureOrders.create({
  amount: 15000,
  description: 'Robe wax taille M',
  customer_phone: '+22370000000',
  idempotency_key: 'order-9',
});
// Le livreur saisit le code de l'acheteur :
await sahelpay.secureOrders.confirmDelivery(order.id, '482913');

export async function POST(request: Request) {
  const rawBody = await request.text();
  const signature = request.headers.get('x-sahelpay-signature');

  if (!signature) {
    return Response.json({ error: 'Invalid signature' }, { status: 401 });
  }

  let event;
  try {
    event = sahelpay.webhooks.constructEvent(
      rawBody,
      signature,
      process.env.SAHELPAY_WEBHOOK_SECRET!
    );
  } catch {
    return Response.json({ error: 'Invalid signature' }, { status: 401 });
  }

  if (event.event === 'payment.success') {
    // Mettre à jour la commande event.data.client_reference
  }

  return Response.json({ received: true });
}

import { SahelPayError } from '@sahelpay/sdk';

try {
  await sahelpay.payments.create({ /* ... */ });
} catch (error) {
  if (error instanceof SahelPayError) {
    console.log(error.code);    // ex. 'IDEMPOTENCY_KEY_REQUIRED'
    console.log(error.message);
  }
}