📄 Hotel-Netz Voucher API (v1.0)

🔗 Quick Info

• Platform: api.hotel-netz.com
• Tenant: hotel_bredeney
• Backend: Flask + PostgreSQL
• Auth: API Key
• Protocol: HTTPS / JSON
• Flow: Hotel-Netz → Your POS → (Optional) Acknowledgment

🔐 Authentication

Include the following headers in your webhook POST handler:

X-API-Key: YOUR_SHARED_SECRET
Content-Type: application/json

Optional: implement IP whitelisting or HMAC verification.

📦 Sample Payload

Outbound: Hotel-Netz → Your POS

{
  "voucher_id": "VCHR-5678",
  "guest_name": "Alice Becker",
  "room_number": "312",
  "timestamp": "2025-04-05T18:45:00Z",
  "campaign": "welcome_drink",
  "status": "issued",
  "notes": "Guest just checked in"
}

Expected POS Acknowledgment (Optional):

{
  "status": "success",
  "message": "Voucher redeemed at POS-01"
}

📫 Technical Contact

Jake Manning
Email: info@hotel-netz.com
Webhook test URL will be shared upon request.

✅ We Provide

• Secure, real-time POST for issued vouchers
• Structured, flexible payload format
• API key-based handshake
• Delivery logs and fallback logic
• OAuth 2.0 readiness (v2.0)

📥 We Need From You

• Your webhook URL
• Your preferred payload/fields (if different)
• Optional acknowledgment schema
• Shared secret or allow us to generate one
• Confirmation: redeem or log-only flow

🛡️ Secure Sovereign Cloud

Hosted on AWS Stockholm with full EEA compliance. Data is encrypted in transit and at rest. Resilience and transparency are core to how we operate.