Confiance webhook
Verifiez l'evenement avant de mettre a jour la commande.
XPayr signe les charges utiles des webhooks avec votre secret. Conservez le corps brut, verifiez X-XPayr-Signature, puis traitez l'evenement de maniere idempotente.
En-tetes a lire
X-XPayr-Signature: Signature HMAC SHA-256 prefixee parsha256=.X-XPayr-Event: type d'evenement tel quepayment.completed.X-XPayr-Delivery: identifiant de livraison/evenement lorsqu'il est disponible.
Extraits de Vérification Multilangages
import crypto from "node:crypto";
export function verifyXPayrWebhook(rawBody, signatureHeader, secret) {
const received = String(signatureHeader || "").replace(/^sha256=/, "");
const expected = crypto
.createHmac("sha256", secret)
.update(rawBody)
.digest("hex");
return crypto.timingSafeEqual(
Buffer.from(received, "hex"),
Buffer.from(expected, "hex")
);
}
Evenements a traiter
Traitez au minimum payment.completed, payment.failed, payment.expired, test.webhook. Utilisez l'ID de session et votre propre ID de commande dans les metadonnees pour le rapprochement.
SDK NPM Officiels (v0.2.0) et Serveur MCP Distant
Intégrez Plus Vite avec les Paquets Officiels XPayr et MCP sans Installation
Installez @xpayr/node-sdk (v0.2.0), @xpayr/payment-evidence (v0.2.0), @xpayr/extension-kit (v0.2.0)ou @xpayr/mcp-server (v1.0.0) depuis NPM, ou exécutez des appels d'outils JSON-RPC 2.0 en direct via POST https://xpayr.com/api/mcp.