API reference

Webhooks

Langganan event domain dan riwayat pengiriman (modul api). Langganan berlaku untuk seluruh organisasi.

OpenAPI 3.1 · version 1.1.0 · 127 operations · 30 webhook events

Download YAML Download JSON Getting started

Base URLhttps://api.medivana.cloud/api/v1

Endpoint descriptions come from the OpenAPI specification and are written in Indonesian.

GET/webhooks

Daftar langganan webhook organisasi

Semua langganan organisasi (termasuk yang dibuat admin di aplikasi atau klien API lain). secret tidak pernah dikembalikan di sini.

Scopes: webhooks:manage
RBAC permissions: api_client.manage · webhook.manage
Module: api

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/webhooks" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/webhooks", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/webhooks",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Langganan (terbaru dulu)application/json

{
  "items": [
    {
      "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001d001",
      "url": "https://his.contoh.test/medivana/webhook",
      "events": [
        "patient.created",
        "encounter.closed",
        "invoice.paid"
      ],
      "description": "Sinkron HIS",
      "is_active": true,
      "failure_count": 0,
      "disabled_reason": null,
      "created_at": "2026-10-29T08:00:00+07:00",
      "version": 1
    }
  ]
}

Schema 200

Schema 200
Name	Type	Description
itemsrequired	array<object>
items[].id	string (uuid)
items[].url	string (uri)
items[].events	array<string (31 nilai)>
items[].description	string \| null
items[].is_active	boolean
items[].failure_count	integer	Kegagalan beruntun; direset setelah pengiriman sukses
items[].disabled_reason	string \| null
items[].created_at	string (date-time)
items[].version	integer

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

POST/webhooks

Buat langganan webhook

url wajib https dan tidak boleh mengarah ke jaringan internal/privat. events berisi nama event dari GET /webhooks/events atau "*" untuk semua event. secret (whsec_…) hanya dikembalikan sekali di respons ini; simpan di brankas rahasia untuk memverifikasi X-Medivana-Signature.

Scopes: webhooks:manage
RBAC permissions: api_client.manage · webhook.manage
Module: api

Request body `application/json`

Request body POST /webhooks
Name	Type	Description
urlrequired	string (uri)
eventsrequired	array<string (31 nilai)>
description	string \| null

{
  "url": "https://his.contoh.test/medivana/webhook",
  "events": [
    "patient.created",
    "encounter.closed",
    "invoice.paid"
  ],
  "description": "Sinkron HIS"
}

Code examples

curlJavaScriptPython

curl -X POST "https://api.medivana.cloud/api/v1/webhooks" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://his.contoh.test/medivana/webhook","events":["patient.created","encounter.closed","invoice.paid"],"description":"Sinkron HIS"}'

const res = await fetch("https://api.medivana.cloud/api/v1/webhooks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://his.contoh.test/medivana/webhook",
    events: [
      "patient.created",
      "encounter.closed",
      "invoice.paid",
    ],
    description: "Sinkron HIS",
  }),
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.post(
    "https://api.medivana.cloud/api/v1/webhooks",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    json={
        "url": "https://his.contoh.test/medivana/webhook",
        "events": [
            "patient.created",
            "encounter.closed",
            "invoice.paid",
        ],
        "description": "Sinkron HIS",
    },
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

201Langganan dibuat (dengan secret sekali tampil)application/json

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001d001",
  "url": "https://his.contoh.test/medivana/webhook",
  "events": [
    "patient.created",
    "encounter.closed",
    "invoice.paid"
  ],
  "description": "Sinkron HIS",
  "is_active": true,
  "failure_count": 0,
  "disabled_reason": null,
  "created_at": "2026-10-29T08:00:00+07:00",
  "version": 1,
  "secret": "whsec_contohRahasiaJanganDipakai"
}

Schema 201

Schema 201
Name	Type	Description
id	string (uuid)
url	string (uri)
events	array<string (31 nilai)>
description	string \| null
is_active	boolean
failure_count	integer	Kegagalan beruntun; direset setelah pengiriman sukses
disabled_reason	string \| null
created_at	string (date-time)
version	integer
secretrequired	string

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
422validationValidasi gagal; rincian per field di errors
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/webhooks/events

Katalog event dan format tanda tangan

Scopes: webhooks:manage
RBAC permissions: api_client.manage · webhook.manage
Module: api

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/webhooks/events" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/webhooks/events", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/webhooks/events",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Katalogapplication/json

{
  "items": [
    "patient.created",
    "patient.updated",
    "encounter.closed"
  ],
  "signature_header": "X-Medivana-Signature",
  "signature_format": "t=<unix>,v1=<hex(HMAC-SHA256(secret, t + \".\" + body))>"
}

Schema 200

Schema 200
Name	Type	Description
items	array<string (31 nilai)>
signature_header	"X-Medivana-Signature"
signature_format	string

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

PATCH/webhooks/{id}

Ubah langganan webhook

is_active: true mengaktifkan kembali langganan yang dinonaktifkan (mis. setelah 410 Gone) dan mereset hitungan kegagalan.

Scopes: webhooks:manage
RBAC permissions: api_client.manage · webhook.manage
Module: api

Parameters

Parameters PATCH /webhooks/{id}
Name	In	Type	Description
idrequired	path	string (uuid)
If-Match	header	string	Versi dari `ETag` (mis. `"3"`). Bila tidak cocok → `412 stale`.

Request body `application/json`

Request body PATCH /webhooks/{id}
Name	Type	Description
url	string (uri)
events	array<string (31 nilai)>
description	string \| null
is_active	boolean

{
  "events": [
    "*"
  ],
  "is_active": true
}

Code examples

curlJavaScriptPython

curl -X PATCH "https://api.medivana.cloud/api/v1/webhooks/3f0c2a10-5b7e-4c1d-9a2e-000000000001" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"events":["*"],"is_active":true}'

const res = await fetch("https://api.medivana.cloud/api/v1/webhooks/3f0c2a10-5b7e-4c1d-9a2e-000000000001", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    events: [
      "*",
    ],
    is_active: true,
  }),
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.patch(
    "https://api.medivana.cloud/api/v1/webhooks/3f0c2a10-5b7e-4c1d-9a2e-000000000001",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    json={
        "events": [
            "*",
        ],
        "is_active": True,
    },
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Langgananapplication/json

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "url": "https://contoh.test/webhook",
  "events": [
    "*"
  ],
  "description": "string",
  "is_active": true,
  "failure_count": 0,
  "disabled_reason": "string",
  "created_at": "2026-11-02T08:00:00+07:00",
  "version": 0
}

Schema 200

Schema 200
Name	Type	Description
id	string (uuid)
url	string (uri)
events	array<string (31 nilai)>
description	string \| null
is_active	boolean
failure_count	integer	Kegagalan beruntun; direset setelah pengiriman sukses
disabled_reason	string \| null
created_at	string (date-time)
version	integer

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
404not-foundData tidak ada, milik organisasi lain, atau di luar cakupan cabang klien
412staleIf-Match tidak cocok dengan versi terbaru
422validationValidasi gagal; rincian per field di errors
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

DELETE/webhooks/{id}

Hapus langganan webhook

Pengiriman yang masih antre untuk langganan ini dilewati.

Scopes: webhooks:manage
RBAC permissions: api_client.manage · webhook.manage
Module: api

Parameters

Parameters DELETE /webhooks/{id}
Name	In	Type	Description
idrequired	path	string (uuid)

Code examples

curlJavaScriptPython

curl -X DELETE "https://api.medivana.cloud/api/v1/webhooks/3f0c2a10-5b7e-4c1d-9a2e-000000000001" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/webhooks/3f0c2a10-5b7e-4c1d-9a2e-000000000001", {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);

import os
import requests

resp = requests.delete(
    "https://api.medivana.cloud/api/v1/webhooks/3f0c2a10-5b7e-4c1d-9a2e-000000000001",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()

Responses

204Dihapus

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
404not-foundData tidak ada, milik organisasi lain, atau di luar cakupan cabang klien
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

POST/webhooks/{id}/rotate-secret

Rotasi secret HMAC

Secret lama langsung tidak berlaku; pengiriman berikutnya ditandatangani secret baru. Perbarui verifikasi di penerima sebelum atau segera setelah rotasi.

Scopes: webhooks:manage
RBAC permissions: api_client.manage · webhook.manage
Module: api

Parameters

Parameters POST /webhooks/{id}/rotate-secret
Name	In	Type	Description
idrequired	path	string (uuid)

Code examples

curlJavaScriptPython

curl -X POST "https://api.medivana.cloud/api/v1/webhooks/3f0c2a10-5b7e-4c1d-9a2e-000000000001/rotate-secret" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/webhooks/3f0c2a10-5b7e-4c1d-9a2e-000000000001/rotate-secret", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.post(
    "https://api.medivana.cloud/api/v1/webhooks/3f0c2a10-5b7e-4c1d-9a2e-000000000001/rotate-secret",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Langganan dengan secret baru (sekali tampil)application/json

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "url": "https://contoh.test/webhook",
  "events": [
    "*"
  ],
  "description": "string",
  "is_active": true,
  "failure_count": 0,
  "disabled_reason": "string",
  "created_at": "2026-11-02T08:00:00+07:00",
  "version": 0,
  "secret": "string"
}

Schema 200

Schema 200
Name	Type	Description
id	string (uuid)
url	string (uri)
events	array<string (31 nilai)>
description	string \| null
is_active	boolean
failure_count	integer	Kegagalan beruntun; direset setelah pengiriman sukses
disabled_reason	string \| null
created_at	string (date-time)
version	integer
secretrequired	string

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
404not-foundData tidak ada, milik organisasi lain, atau di luar cakupan cabang klien
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

POST/webhooks/{id}/test

Kirim event uji `ping`

Mengantrekan event ping ke URL langganan (lihat riwayat pengiriman untuk hasilnya).

Scopes: webhooks:manage
RBAC permissions: api_client.manage · webhook.manage
Module: api

Parameters

Parameters POST /webhooks/{id}/test
Name	In	Type	Description
idrequired	path	string (uuid)

Code examples

curlJavaScriptPython

curl -X POST "https://api.medivana.cloud/api/v1/webhooks/3f0c2a10-5b7e-4c1d-9a2e-000000000001/test" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/webhooks/3f0c2a10-5b7e-4c1d-9a2e-000000000001/test", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.post(
    "https://api.medivana.cloud/api/v1/webhooks/3f0c2a10-5b7e-4c1d-9a2e-000000000001/test",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

202Diantrekanapplication/json

{
  "status": "queued"
}

Schema 202

Schema 202
Name	Type	Description
status	"queued"

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
404not-foundData tidak ada, milik organisasi lain, atau di luar cakupan cabang klien
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/webhooks/{id}/deliveries

Riwayat pengiriman webhook

Terbaru dulu. pending (antre), delivered (2xx), failed (akan dicoba ulang), dead (percobaan habis atau 410).

Scopes: webhooks:manage
RBAC permissions: api_client.manage · webhook.manage
Module: api

Parameters

Parameters GET /webhooks/{id}/deliveries
Name	In	Type	Description
idrequired	path	string (uuid)
status	query	pending \| delivered \| failed \| dead
limit	query	integer
cursor	query	string	Nilai `next_cursor` dari halaman sebelumnya

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/webhooks/3f0c2a10-5b7e-4c1d-9a2e-000000000001/deliveries" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/webhooks/3f0c2a10-5b7e-4c1d-9a2e-000000000001/deliveries", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/webhooks/3f0c2a10-5b7e-4c1d-9a2e-000000000001/deliveries",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Pengirimanapplication/json

{
  "items": [
    {
      "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001d101",
      "subscription_id": "3f0c2a10-5b7e-4c1d-9a2e-00000001d001",
      "event": "patient.created",
      "event_id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
      "entity_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
      "status": "delivered",
      "attempts": 1,
      "last_status_code": 200,
      "last_error": null,
      "delivered_at": "2026-10-29T08:15:03+07:00",
      "created_at": "2026-10-29T08:15:02+07:00",
      "payload": {
        "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
        "type": "patient.created",
        "created_at": "2026-10-29T01:15:02Z",
        "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
        "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
        "data": {
          "id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
          "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1"
        }
      }
    }
  ]
}

Schema 200

Schema 200
Name	Type	Description
itemsrequired	array<object>
items[].id	string (uuid)
items[].subscription_id	string (uuid)
items[].event	string (31 nilai)
items[].event_id	string (uuid)
items[].entity_id	string \| null
items[].status	pending \| delivered \| failed \| dead
items[].attempts	integer
items[].last_status_code	integer \| null
items[].last_error	string \| null
items[].delivered_at	string (date-time) \| null
items[].created_at	string (date-time)
items[].payload	object
items[].payload.idrequired	string (uuid)	ID event (= header X-Medivana-Event-ID); pakai untuk deduplikasi
items[].payload.typerequired	string (31 nilai)
items[].payload.created_atrequired	string (date-time)	Waktu event (UTC)
items[].payload.org_idrequired	string (uuid)
items[].payload.branch_id	string (uuid)	Tidak ada untuk event tingkat organisasi
items[].payload.datarequired	object	`id` entitas + kunci data event. Ambil detail lengkap lewat API dengan token.
next_cursor	string

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
404not-foundData tidak ada, milik organisasi lain, atau di luar cakupan cabang klien
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

POST/webhooks/deliveries/{id}/redeliver

Kirim ulang satu pengiriman

Payload dan X-Medivana-Event-ID sama dengan pengiriman asli (deduplikasi di penerima tetap berlaku); tanda tangan dihitung ulang dengan waktu dan secret saat ini.

Scopes: webhooks:manage
RBAC permissions: api_client.manage · webhook.manage
Module: api

Parameters

Parameters POST /webhooks/deliveries/{id}/redeliver
Name	In	Type	Description
idrequired	path	string (uuid)

Code examples

curlJavaScriptPython

curl -X POST "https://api.medivana.cloud/api/v1/webhooks/deliveries/3f0c2a10-5b7e-4c1d-9a2e-000000000001/redeliver" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/webhooks/deliveries/3f0c2a10-5b7e-4c1d-9a2e-000000000001/redeliver", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.post(
    "https://api.medivana.cloud/api/v1/webhooks/deliveries/3f0c2a10-5b7e-4c1d-9a2e-000000000001/redeliver",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

202Diantrekanapplication/json

{
  "status": "queued"
}

Schema 202

Schema 202
Name	Type	Description
status	"queued"

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
404not-foundData tidak ada, milik organisasi lain, atau di luar cakupan cabang klien
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

Webhook event catalog

Every event payload contains id, type, created_at, org_id, branch_id (when present), and data. Fetch full details through the API using data.id.

POSTping

Uji koneksi

Dikirim oleh POST /webhooks/{id}/test. Data entitas: data.id = ID langganan (subscription_id).

Data fields

Data fields ping
Name	Type	Description
idrequired	string	ID langganan (subscription_id)
message	string

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "ping",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001d001",
    "message": "Tes webhook Medivana"
  }
}

POSTpatient.created

Pasien baru terdaftar

Setelah POST /patients atau pendaftaran di aplikasi. Data entitas: data.id = patient_id.

Data fields

Data fields patient.created
Name	Type	Description
idrequired	string	patient_id
branch_id	string (uuid)

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "patient.created",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1"
  }
}

POSTpatient.updated

Data pasien berubah

Identitas atau kontak pasien diubah. Data entitas: data.id = patient_id.

Data fields

Data fields patient.updated
Name	Type	Description
idrequired	string	patient_id
branch_id	string (uuid)

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "patient.updated",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1"
  }
}

POSTpatient.merged

Pasien ganda digabung

data.id = pasien yang dipertahankan; merged_from = pasien sumber yang kini nonaktif (merged_into). Pindahkan referensi di sistem Anda. Data entitas: data.id = patient_id (tujuan).

Data fields

Data fields patient.merged
Name	Type	Description
idrequired	string	patient_id (tujuan)
merged_from	string (uuid)
branch_id	string (uuid)

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "patient.merged",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "merged_from": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0002",
    "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1"
  }
}

POSTencounter.started

Kunjungan terdaftar

Saat pendaftaran kunjungan (termasuk check-in booking). appointment_id bernilai UUID nol bila bukan dari booking. Data entitas: data.id = encounter_id.

Data fields

Data fields encounter.started
Name	Type	Description
idrequired	string	encounter_id
patient_id	string (uuid)
unit_id	string (uuid)
practitioner_id	string (uuid) \| null
payer_id	string (uuid)
payer_kind	string
appointment_id	string (uuid) \| null
queue_id	string (uuid)

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "encounter.started",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-0000000e0001",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "unit_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000c0001",
    "practitioner_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000d0001",
    "payer_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000f0001",
    "payer_kind": "umum",
    "appointment_id": null,
    "queue_id": "3f0c2a10-5b7e-4c1d-9a2e-000000005001"
  }
}

POSTencounter.closed

Kunjungan ditutup dan ditandatangani

Rekam medis kunjungan final (tanda tangan elektronik). Ambil isi lengkap lewat GET /encounters/{id}. Data entitas: data.id = encounter_id.

Data fields

Data fields encounter.closed
Name	Type	Description
idrequired	string	encounter_id
patient_id	string (uuid)
practitioner_id	string (uuid) \| null
payer_id	string (uuid)
payer_kind	string
unit_id	string (uuid)
appointment_id	string (uuid)
signature_id	string (uuid)

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "encounter.closed",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-0000000e0001",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "practitioner_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000d0001",
    "payer_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000f0001",
    "payer_kind": "umum",
    "unit_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000c0001",
    "appointment_id": "00000000-0000-0000-0000-000000000000",
    "signature_id": "3f0c2a10-5b7e-4c1d-9a2e-000000006301"
  }
}

POSTencounter.cancelled

Kunjungan dibatalkan

Data entitas: data.id = encounter_id.

Data fields

Data fields encounter.cancelled
Name	Type	Description
idrequired	string	encounter_id
patient_id	string (uuid)
reason	string

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "encounter.cancelled",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-0000000e0001",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "reason": "Pasien pulang sebelum diperiksa"
  }
}

POSTallergy.recorded

Alergi dicatat

Data entitas: data.id = allergy_id.

Data fields

Data fields allergy.recorded
Name	Type	Description
idrequired	string	allergy_id
patient_id	string (uuid)
encounter_id	string (uuid)
category	obat \| makanan \| lingkungan
severity	ringan \| sedang \| berat

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "allergy.recorded",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a8001",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "encounter_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000e0001",
    "category": "obat",
    "severity": "berat"
  }
}

POSTqueue.called

Nomor antrean dipanggil

Termasuk panggil ulang (call_count bertambah). Data entitas: data.id = queue_id.

Data fields

Data fields queue.called
Name	Type	Description
idrequired	string	queue_id
patient_id	string (uuid)
unit_id	string (uuid)
number	integer
label	string
encounter_id	string (uuid)
call_count	integer

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "queue.called",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-000000005001",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "unit_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000c0001",
    "number": 3,
    "label": "U-003",
    "encounter_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000e0001",
    "call_count": 1
  }
}

POSTprescription.created

Resep dibuat

Modul farmasi. Data entitas: data.id = prescription_id.

Data fields

Data fields prescription.created
Name	Type	Description
idrequired	string	prescription_id
patient_id	string (uuid)
encounter_id	string (uuid)

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "prescription.created",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-000000001001",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "encounter_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000e0001"
  }
}

POSTdispense.completed

Obat diserahkan

Modul farmasi. Data entitas: data.id = dispense_id.

Data fields

Data fields dispense.completed
Name	Type	Description
idrequired	string	dispense_id
patient_id	string (uuid)
encounter_id	string (uuid)
prescription_id	string (uuid)

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "dispense.completed",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-000000001101",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "encounter_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000e0001",
    "prescription_id": "3f0c2a10-5b7e-4c1d-9a2e-000000001001"
  }
}

POSTdispense.returned

Obat diretur

billed_charges = jumlah charge retur yang sudah ditagih (memicu nota kredit). Data entitas: data.id = dispense_id.

Data fields

Data fields dispense.returned
Name	Type	Description
idrequired	string	dispense_id
patient_id	string (uuid)
encounter_id	string (uuid)
return_id	string (uuid)
reason	string
billed_charges	integer

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "dispense.returned",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-000000001101",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "encounter_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000e0001",
    "return_id": "3f0c2a10-5b7e-4c1d-9a2e-000000001201",
    "reason": "Pasien alergi",
    "billed_charges": 0
  }
}

POSTlab.order_created

Order laboratorium dibuat

Satu event per pemeriksaan; order sekali kirim berbagi request_id. Data entitas: data.id = order_id.

Data fields

Data fields lab.order_created
Name	Type	Description
idrequired	string	order_id
patient_id	string (uuid)
encounter_id	string (uuid)
service_id	string (uuid)
request_id	string (uuid)
priority	routine \| cito

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "lab.order_created",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001c001",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "encounter_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000e0001",
    "service_id": "3f0c2a10-5b7e-4c1d-9a2e-00000001f001",
    "request_id": "3f0c2a10-5b7e-4c1d-9a2e-00000001c0a0",
    "priority": "cito"
  }
}

POSTradiology.order_created

Order radiologi dibuat

Data entitas: data.id = order_id.

Data fields

Data fields radiology.order_created
Name	Type	Description
idrequired	string	order_id
patient_id	string (uuid)
encounter_id	string (uuid)
service_id	string (uuid)
request_id	string (uuid)
priority	routine \| cito

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "radiology.order_created",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001c101",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "encounter_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000e0001",
    "service_id": "3f0c2a10-5b7e-4c1d-9a2e-00000001f001",
    "request_id": "3f0c2a10-5b7e-4c1d-9a2e-00000001c0a0",
    "priority": "routine"
  }
}

POSTlab.result_final

Hasil laboratorium final

critical: true bila ada nilai kritis. Ambil hasil lewat GET /lab/orders/{id}. Data entitas: data.id = order_id.

Data fields

Data fields lab.result_final
Name	Type	Description
idrequired	string	order_id
patient_id	string (uuid)
encounter_id	string (uuid)
request_id	string (uuid)
service_id	string (uuid)
critical	boolean

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "lab.result_final",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001c001",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "encounter_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000e0001",
    "request_id": "3f0c2a10-5b7e-4c1d-9a2e-00000001c0a0",
    "service_id": "3f0c2a10-5b7e-4c1d-9a2e-00000001f001",
    "critical": true
  }
}

POSTradiology.result_final

Ekspertise radiologi final

Ambil ekspertise dan berkas lewat GET /radiology/orders/{id}. Data entitas: data.id = order_id.

Data fields

Data fields radiology.result_final
Name	Type	Description
idrequired	string	order_id
patient_id	string (uuid)
encounter_id	string (uuid)
request_id	string (uuid)
service_id	string (uuid)
critical	boolean

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "radiology.result_final",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001c101",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "encounter_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000e0001",
    "request_id": "3f0c2a10-5b7e-4c1d-9a2e-00000001c0a0",
    "service_id": "3f0c2a10-5b7e-4c1d-9a2e-00000001f001",
    "critical": false
  }
}

POSTimmunization.recorded

Imunisasi dicatat

Modul KIA. encounter_id null bila dicatat tanpa kunjungan. Data entitas: data.id = immunization_id.

Data fields

Data fields immunization.recorded
Name	Type	Description
idrequired	string	immunization_id
patient_id	string (uuid)
encounter_id	string (uuid) \| null
vaccine_code	string
dose_no	integer

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "immunization.recorded",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-000000003101",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0003",
    "encounter_id": null,
    "vaccine_code": "DPT-HB-HIB",
    "dose_no": 1
  }
}

POSTappointment.booked

Booking dibuat atau dijadwal ulang

rescheduled: true bila berasal dari jadwal ulang. patient_id null untuk pasien baru yang belum terdaftar. Data entitas: data.id = appointment_id.

Data fields

Data fields appointment.booked
Name	Type	Description
idrequired	string	appointment_id
patient_id	string (uuid) \| null
practitioner_id	string (uuid)
start_at	string (date-time)
unit_id	string (uuid)
source	string
code	string
rescheduled	boolean

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "appointment.booked",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001a001",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "practitioner_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000d0001",
    "start_at": "2026-11-02T08:15:00+07:00",
    "unit_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000c0001",
    "source": "admin",
    "code": "BK-7KQ2MZ"
  }
}

POSTappointment.cancelled

Booking dibatalkan

Data entitas: data.id = appointment_id.

Data fields

Data fields appointment.cancelled
Name	Type	Description
idrequired	string	appointment_id
patient_id	string (uuid) \| null
practitioner_id	string (uuid)
start_at	string (date-time)
reason	string

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "appointment.cancelled",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001a001",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "practitioner_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000d0001",
    "start_at": "2026-11-02T08:15:00+07:00",
    "reason": "Pasien berhalangan"
  }
}

POSTappointment.checked_in

Pasien check-in booking

Kunjungan dan antrean dibuat otomatis (lihat encounter.started). Data entitas: data.id = appointment_id.

Data fields

Data fields appointment.checked_in
Name	Type	Description
idrequired	string	appointment_id
appointment_id	string (uuid)
patient_id	string (uuid)
practitioner_id	string (uuid)
unit_id	string (uuid)
payer_id	string (uuid) \| null
payer_kind	string
branch_id	string (uuid)
start_at	string (date-time)
complaint	string
chief_complaint	string
source	string
service_id	string (uuid) \| null

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "appointment.checked_in",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001a001",
    "appointment_id": "3f0c2a10-5b7e-4c1d-9a2e-00000001a001",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "practitioner_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000d0001",
    "unit_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000c0001",
    "payer_id": null,
    "payer_kind": "umum",
    "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
    "start_at": "2026-11-02T08:15:00+07:00",
    "complaint": "Demam 3 hari",
    "chief_complaint": "Demam 3 hari",
    "source": "admin",
    "service_id": null
  }
}

POSTinvoice.finalized

Tagihan final (nomor terbit)

Bila bagian pasien 0, langsung diikuti invoice.paid. Data entitas: data.id = invoice_id.

Data fields

Data fields invoice.finalized
Name	Type	Description
idrequired	string	invoice_id
patient_id	string (uuid)
encounter_id	string (uuid)
payer_id	string (uuid)
total	string	Angka desimal rupiah sebagai string
patient_amount	string	Angka desimal rupiah sebagai string
payer_amount	string	Angka desimal rupiah sebagai string

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "invoice.finalized",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001b001",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "encounter_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000e0001",
    "payer_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000f0001",
    "total": "195000",
    "patient_amount": "195000",
    "payer_amount": "0"
  }
}

POSTinvoice.paid

Tagihan lunas (bagian pasien)

Data entitas: data.id = invoice_id.

Data fields

Data fields invoice.paid
Name	Type	Description
idrequired	string	invoice_id
patient_id	string (uuid)
encounter_id	string (uuid)

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "invoice.paid",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001b001",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "encounter_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000e0001"
  }
}

POSTinvoice.voided

Tagihan dibatalkan (void)

Data entitas: data.id = invoice_id.

Data fields

Data fields invoice.voided
Name	Type	Description
idrequired	string	invoice_id
patient_id	string (uuid)
encounter_id	string (uuid)
reason	string

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "invoice.voided",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001b001",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
    "encounter_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000e0001",
    "reason": "Salah penjamin"
  }
}

POSTpayment.received

Pembayaran diterima

Satu event per pembayaran (pembayaran campuran → beberapa event). Data entitas: data.id = payment_id.

Data fields

Data fields payment.received
Name	Type	Description
idrequired	string	payment_id
invoice_id	string (uuid)
amount	string	Angka desimal rupiah sebagai string
method	cash \| debit \| credit \| qris \| transfer \| deposit
patient_id	string (uuid)

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "payment.received",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001b101",
    "invoice_id": "3f0c2a10-5b7e-4c1d-9a2e-00000001b001",
    "amount": "195000",
    "method": "qris",
    "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001"
  }
}

POSTclaim.submitted

Klaim penjamin diajukan

Modul klaim. kind = jenis klaim. Data entitas: data.id = claim_id.

Data fields

Data fields claim.submitted
Name	Type	Description
idrequired	string	claim_id
payer_id	string (uuid)
amount	string	Angka desimal rupiah sebagai string
kind	string

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "claim.submitted",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-000000001301",
    "payer_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000f0003",
    "amount": "1250000",
    "kind": "insurance"
  }
}

POSTclaim.paid

Klaim dibayar penjamin

amount = nominal pembayaran yang dicatat. Data entitas: data.id = claim_id.

Data fields

Data fields claim.paid
Name	Type	Description
idrequired	string	claim_id
payer_id	string (uuid)
amount	string	Angka desimal rupiah sebagai string
kind	string

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "claim.paid",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-000000001301",
    "payer_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000f0003",
    "amount": "1200000",
    "kind": "insurance"
  }
}

POSTclaim.rejected

Klaim ditolak penjamin

Data entitas: data.id = claim_id.

Data fields

Data fields claim.rejected
Name	Type	Description
idrequired	string	claim_id
payer_id	string (uuid)
amount	string	Angka desimal rupiah sebagai string
kind	string

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "claim.rejected",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-000000001301",
    "payer_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000f0003",
    "amount": "1250000",
    "kind": "insurance"
  }
}

POSTstock.below_minimum

Stok di bawah minimum

Maksimal sekali per barang per gudang per hari. data.id = ID barang. Data entitas: data.id = item_id.

Data fields

Data fields stock.below_minimum
Name	Type	Description
idrequired	string	item_id
warehouse_id	string (uuid)
on_hand	string	Angka desimal rupiah sebagai string
min_stock	string	Angka desimal rupiah sebagai string

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "stock.below_minimum",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-000000001401",
    "warehouse_id": "3f0c2a10-5b7e-4c1d-9a2e-000000001501",
    "on_hand": "8",
    "min_stock": "20"
  }
}

POSTsubscription.activated

Langganan Medivana aktif

Paket organisasi aktif (tanpa branch_id). Data entitas: data.id = subscription_id.

Data fields

Data fields subscription.activated
Name	Type	Description
idrequired	string	subscription_id
plan	string
billing_cycle	string
branches	integer

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "subscription.activated",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-000000001601",
    "plan": "klinik_pro",
    "billing_cycle": "annual",
    "branches": 3
  }
}

POSTsubscription.changed

Paket langganan berubah

Upgrade/downgrade paket (tanpa branch_id). Data entitas: data.id = subscription_id.

Data fields

Data fields subscription.changed
Name	Type	Description
idrequired	string	subscription_id
plan	string
previous_plan	string
billing_cycle	string

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001e001",
  "type": "subscription.changed",
  "created_at": "2026-10-29T01:15:02Z",
  "org_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "data": {
    "id": "3f0c2a10-5b7e-4c1d-9a2e-000000001601",
    "plan": "enterprise",
    "previous_plan": "klinik_pro",
    "billing_cycle": "annual"
  }
}

Webhooks

Daftar langganan webhook organisasi

Code examples

Responses

Errors

Buat langganan webhook

Request body application/json

Code examples

Responses

Errors

Katalog event dan format tanda tangan

Code examples

Responses

Errors

Ubah langganan webhook

Parameters

Request body application/json

Code examples

Responses

Errors

Hapus langganan webhook

Parameters

Code examples

Responses

Errors

Rotasi secret HMAC

Parameters

Code examples

Responses

Errors

Kirim event uji ping

Parameters

Code examples

Responses

Errors

Riwayat pengiriman webhook

Parameters

Code examples

Responses

Errors

Kirim ulang satu pengiriman

Parameters

Code examples

Responses

Errors

Webhook event catalog

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Data fields

Request body `application/json`

Request body `application/json`

Kirim event uji `ping`