Skip to main content

Webhook Setup

Coming Soon

Webhooks are planned for Sprint 4. This page will be updated when the feature is available.

Planned Features​

Webhooks will allow you to receive real-time notifications for:

  • Verification events — When a code is scanned
  • Counterfeit alerts — Immediate notification of detected counterfeits
  • Transfer completions — When ownership transfers complete
  • Rate limit warnings — Before you hit your limits

Expected Configuration​

// Example webhook payload (planned)
{
  "event": "verification.completed",
  "timestamp": "2026-03-01T10:30:00Z",
  "data": {
    "serial": "SN-2026-001",
    "verdict": "AUTHENTIC",
    "confidence": 0.95,
    "location": {
      "country": "DE",
      "city": "Munich"
    }
  }
}

Security​

Webhooks will include:

  • HMAC signatures for payload verification
  • Retry logic with exponential backoff
  • Event filtering to reduce noise

Register Interest​

To be notified when webhooks launch, contact us at api@optropic.com.