npm install @sahelpay/sdk
# ou
yarn add @sahelpay/sdk

import SahelPay from '@sahelpay/sdk';

const sahelpay = new SahelPay({
  secretKey: process.env.SAHELPAY_SECRET_KEY!,
  environment: 'sandbox' // sk_test_... utilise https://api.sahelpay.ml
});

const payment = await sahelpay.payments.create({
  amount: 5000,
  currency: 'XOF',
  payment_method: 'ORANGE_MONEY', // seul rail intégré aujourd'hui
  customer_phone: '+22370123456',
  return_url: 'https://votre-site.com/checkout/return',
  description: 'Commande #123',
  sandbox: true, // environnement de test de l'opérateur
});

// Rediriger le client vers Orange Money
window.location.href = payment.redirect_url;

const payment = await sahelpay.payments.create({
  amount: 4000,
  payment_method: 'ORANGE_MONEY',
  customer_phone: '+22370123456',
  return_url: 'https://votre-site.com/checkout/return',
  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('txn_abc123');

console.log(result.status); // 'PENDING' | 'SUCCESS' | 'FAILED' | 'EXPIRED'
console.log(result.payment.amount);
console.log(result.payment.provider_ref);

// Dans votre handler webhook
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 payload;
  try {
    payload = sahelpay.webhooks.constructEvent(
      rawBody,
      signature,
      process.env.SAHELPAY_WEBHOOK_SECRET!
    );
  } catch {
    return Response.json({ error: 'Invalid signature' }, { status: 401 });
  }

  const { event, data } = payload;

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

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

import type {
  PaymentResult,
  PaymentStatus,
  WebhookPayload,
  WebhookVerificationResult,
} from '@sahelpay/sdk/merchant';

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

try {
  const payment = await sahelpay.payments.create({ ... });
} catch (error) {
  if (error instanceof SahelPayError) {
    console.log(error.code);    // 'INVALID_AMOUNT'
    console.log(error.message); // 'Montant minimum: 100 FCFA'
  }
}

const payment = await sahelpay.payments.create({ ... });

console.log(payment.gateway_used);    // Identifiant technique interne
console.log(payment.routing_reason);  // Explication du routing choisi

import { hasCapability, getMethodsWithCapability } from '@sahelpay/sdk';

// Vérifier si Orange Money supporte les payouts
hasCapability('ORANGE_MONEY', 'payouts'); // true

// Lister les méthodes avec QR code natif
getMethodsWithCapability('payouts'); // ['ORANGE_MONEY']