Webhooks & events

PayFast ITN

Configure notify URL: `https://one.magoven.io/api/billing/payfast/notify`

PayFast POSTs payment status on completion. One verifies signature, marks transaction paid, applies plan to org, and sends invoice email.

Activity feed

POST `/api/external/activity` with bridge secret to log events visible in one.magoven.io/activity.

Example body: ``` { "orgId": "org_abc", "type": "meet.recording", "title": "Recording saved", "actorEmail": "[email protected]" } ```

Meeting → CRM sync

When policy workCrmAutoNotesFromMeetings is enabled, magMeet POSTs summaries to `/api/external/meeting-summary`. magWork creates timeline notes on linked deals.

Ozow notifications

Ozow payments notify `/api/billing/ozow/notify` with similar fulfillment flow.

Best practices

- Verify webhook signatures before processing - Respond 200 quickly — retry async work - Use idempotent handlers (check transaction status before apply)