Webhooks

Webhooks let you receive real-time HTTP notifications when events happen on Neura Market. Instead of polling the API for changes, webhooks push data to your server instantly.

Useful for:

• Getting notified of new sales immediately.
• Triggering fulfillment workflows when a purchase completes.
• Syncing product data with your own systems.
• Building custom dashboards and analytics.

1. Go to Account Settings → Developer → Webhooks.
2. Click Add Webhook Endpoint.
3. Enter your server's URL (must be HTTPS).
4. Select which events you want to receive.
5. Save — you'll receive a signing secret for verifying payloads.

Available events:

• purchase.completed — A buyer completed a purchase.
• purchase.refunded — A purchase was refunded.
• listing.approved — Your listing was approved and is now live.
• listing.rejected — Your listing was rejected during review.
• review.created — A buyer left a review on your product.

Every webhook request includes a signature header for verification:

X-Neura-Signature: sha256=...

Verify the signature by computing an HMAC-SHA256 of the raw request body using your signing secret:

const crypto = require('crypto');
const signature = crypto
  .createHmac('sha256', webhookSecret)
  .update(rawBody)
  .digest('hex');
const isValid = signature === receivedSignature;

Always verify signatures before processing webhook payloads.