Integrations

Medova integrates with popular platforms and services. This guide covers available integrations and how to configure them.

Webhooks

Receive real-time notifications when events occur in Medova.

Supported Events

Configuration

1. Navigate to Dashboard → Settings → Webhooks
2. Add your endpoint URL (must be HTTPS)
3. Select events to subscribe to
4. Copy the signing secret for verification

Verification

All webhook payloads include an X-Medova-Signature header (HMAC-SHA256). Verify this to ensure authenticity:

const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

Stripe

Medova uses Stripe for payment processing. Clinic partners can connect their Stripe account for direct payouts.

Stripe Connect

1. Navigate to Dashboard → Billing → Connect Stripe
2. Complete the Stripe onboarding flow
3. Booking payments are automatically split: clinic share (85%) + platform fee (15%)

Google Maps

Clinic locations are displayed using Google Maps. The integration powers:

• Clinic search by proximity
• Interactive maps on country and city pages
• Directions and travel time estimates

Embeddable Widget

Embed a vaccination requirement checker on your website:

<iframe
  src="https://medova.health/widget/requirements?country=TH&locale=en"
  width="400"
  height="600"
  frameborder="0"
  title="Medova Vaccination Requirements"
></iframe>

Widget customization options (query parameters):

• country — pre-select destination country (ISO2)
• locale — language (default: en)
• theme — light or dark
• hide_header — true to remove the Medova branding header

Calendar Integration

Clinic appointment bookings can sync with:

• Google Calendar — automatic event creation with appointment details
• Outlook / Microsoft 365 — via .ics file download
• Apple Calendar — via .ics file download

Coming Soon

• Slack notifications — outbreak alerts in your Slack channel
• Zapier connector — connect Medova to 5,000+ apps
• FHIR R4 export — healthcare interoperability standard