Node.js — @pismile/node

Pages de paiement, demandes de paiement et vérification des webhooks pour Node.js 18+. Aucune dépendance.

1 min de lecture · Mis à jour le 25/10/2026 · API v1

@pismile/node fait les appels à l'API paiements et vérifie les webhooks. TypeScript inclus, aucune dépendance, Node.js 18 ou plus.

Terminal

npm install @pismile/node

.env

PISMILE_CLIENT_ID=VOTRE_CLIENT_ID        # ou AUTH_PISMILE_ID (comme @pismile/authjs)
PISMILE_CLIENT_SECRET=votre_secret     # ou AUTH_PISMILE_SECRET
PISMILE_WEBHOOK_SECRET=whsec_...

Utilisation#

TypeScript

import { Pismile, PismileErreur } from "@pismile/node"

const pismile = new Pismile()

// Page de paiement (bouton « Payer avec Alias PI-SPI »)
const page = await pismile.sessions.creer({
  montant: 25000, reference: "cmd-42", motif: "Commande 42",
  retour: "https://votre-site.com/commandes/42/merci",
})
// → redirigez vers page.url

// Webhook (corps BRUT)
const evenement = pismile.webhooks.verifier(corpsBrut, req.headers["pismile-signature"])
if (evenement.type === "session.payee") { /* evenement.donnees.reference */ }

// Demande à un utilisateur connecté (scope pismile:payment)
await pismile.paiements.creer({ sub, montant: 5000, reference: "facture-1042" })

Méthode	Rôle
`sessions.creer({ montant, reference, retour, motif?, annulation? })`	Crée la page de paiement (même page pour la même référence)
`sessions.lire(id)` · `sessions.lireParReference(ref)`	Relit une page
`paiements.creer({ sub, montant, reference, motif? })`	Envoie une demande de paiement
`paiements.lire(id)` · `paiements.lireParReference(ref)`	Relit une demande
`webhooks.verifier(corpsBrut, entete)`	Vérifie la signature et renvoie l'événement typé

Les erreurs sont des PismileErreur (code, statut, message). Le SDK réessaie de lui-même après une coupure réseau ou une erreur serveur temporaire.

Exemples complets (Express, Next.js) : Le bouton « Payer avec Alias PI-SPI » et le README du paquet.

Cette page vous a-t-elle aidé ?