Votre premier paiement de test, étape par étape

# Obtenez un jeton d’accès sur Stage (valable 5 minutes)
curl -X POST https://api.stage.localpayment.com/api/token/ \
  -H "Content-Type: application/json" \
  -d "{\"username\": \"$LP_API_USER\", \"password\": \"$LP_API_PASSWORD\"}"

// Récepteur Express pour les webhooks Localpayment (Node.js 18+).
import crypto from 'node:crypto';
import express from 'express';
import { jobQueue } from './queue.js'; // votre propre file de tâches asynchrones

const app = express();

// Chargez le secret du webhook depuis votre gestionnaire de secrets au démarrage. Jamais en dur dans le code.
const WEBHOOK_SECRET = process.env.LP_WEBHOOK_SECRET;
if (!WEBHOOK_SECRET) throw new Error('LP_WEBHOOK_SECRET is not configured');

function hasValidSignature(rawBody, header) {
  if (typeof rawBody !== 'string') return false;
  // Format de l’en-tête : "x-Signature: HMAC-SHA256 <hex>". Retirez d’abord le préfixe.
  const received = String(header ?? '').replace(/^HMAC-SHA256\s+/i, '').trim();
  if (!/^[0-9a-f]{64}$/i.test(received)) return false;

  const expected = crypto.createHmac('sha256', WEBHOOK_SECRET).update(rawBody, 'utf8').digest();
  return crypto.timingSafeEqual(Buffer.from(received, 'hex'), expected);
}

// Le corps est du JSON envoyé en Content-Type text/plain : conservez le texte brut pour le HMAC.
app.post('/webhooks/localpayment', express.text({ type: '*/*', limit: '1mb' }), (req, res) => {
  if (!hasValidSignature(req.body, req.get('x-signature'))) return res.sendStatus(401);

  let event;
  try {
    event = JSON.parse(req.body);
  } catch {
    return res.sendStatus(400);
  }

  res.sendStatus(200); // accusez réception vite, avant tout traitement lourd
  // Traitez de façon asynchrone. Dédupliquez sur internalId/externalId + statut
  // pour qu’une livraison renvoyée ne s’applique qu’une fois. Ne journalisez jamais le payload complet.
  jobQueue.enqueue(event);
});