@spiritpay/node

SDK officiel Spirit Pay (Node.js).

Installation

npm install @spiritpay/node

Exemple — créer un lien de paiement (facture)

import { createClient } from '@spiritpay/node';

const spiritpay = createClient({
  apiKey: process.env.SPIRITPAY_API_KEY, // sk_test_... / sk_live_...
});

const payment = await spiritpay.invoices.create({
  amount: 10000,
  currency: 'EUR',
  invoiceRef: 'FAC-2026-001',
  dueDate: '2026-05-06',
  payerName: 'Client SAS',
  payerEmail: '[email protected]',
  erpProvider: 'odoo',
  erpInvoiceId: '12345',
});

console.log(payment.paymentLink);

Webhooks — vérification de signature

Le backend SpiritPay signe les webhooks via X-Spirit-Pay-Signature: sha256=<hex>.

Important : il faut vérifier la signature avec le raw body (non parsé / non modifié).

import express from 'express';
import { createClient } from '@spiritpay/node';

const app = express();
const spiritpay = createClient({ apiKey: 'sk_test_...' });

app.post('/webhooks/spiritpay', express.raw({ type: 'application/json' }), (req, res) => {
  const ok = spiritpay.webhooks.verifySignature({
    secret: process.env.SPIRITPAY_WEBHOOK_SECRET, // whsec_... (ou sha256 hex)
    headers: req.headers,
    rawBody: req.body,
  });

  if (!ok) return res.status(401).send('Invalid signature');

  const event = JSON.parse(req.body.toString('utf8'));
  // traiter event...
  res.json({ received: true });
});

Support

Si tu veux, je peux t’aider à publier ce package sur npm (organisation @spiritpay) et à mettre à jour la doc du dashboard.