> ## Documentation Index
> Fetch the complete documentation index at: https://docs.simplus.id/llms.txt
> Use this file to discover all available pages before exploring further.

# Mengaktifkan Webhook

> Cara mengaktifkan webhook di aplikasi Simplus dan mendaftarkan endpoint lewat portal webhook.

Aktifkan webhook dari aplikasi Simplus, lalu daftarkan endpoint kamu di portal webhook.

## Mengaktifkan webhook di aplikasi

<Steps>
  <Step title="Buka pengaturan umum">
    Di halaman **Beranda**, tekan menu **Umum** di bagian **Pengaturan**.

    <Frame>
      <img src="https://mintcdn.com/simplus/I4ux79tJi2Xrpq8U/images/integration/webhook/step1.webp?fit=max&auto=format&n=I4ux79tJi2Xrpq8U&q=85&s=06839ec697afc99e32e5d8404b140ca9" alt="Menu Umum di bagian Pengaturan pada halaman Beranda Simplus" width="1010" height="660" data-path="images/integration/webhook/step1.webp" />
    </Frame>
  </Step>

  <Step title="Buka pengaturan notifikasi">
    Di halaman **Pengaturan Umum**, gulir ke bagian **Notifikasi**, lalu tekan **Pengaturan Notifikasi**.

    <Frame>
      <img src="https://mintcdn.com/simplus/I4ux79tJi2Xrpq8U/images/integration/webhook/step2.webp?fit=max&auto=format&n=I4ux79tJi2Xrpq8U&q=85&s=9c3e6fba51dac070e569b11826761f5f" alt="Menu Pengaturan Notifikasi di halaman Pengaturan Umum" width="1300" height="864" data-path="images/integration/webhook/step2.webp" />
    </Frame>
  </Step>

  <Step title="Aktifkan toggle webhook">
    Gulir ke bagian **Integrasi**, lalu aktifkan toggle **Webhook**.

    <Frame>
      <img src="https://mintcdn.com/simplus/I4ux79tJi2Xrpq8U/images/integration/webhook/step3.webp?fit=max&auto=format&n=I4ux79tJi2Xrpq8U&q=85&s=76951f79fe29158bc6391e41af90e305" alt="Toggle Webhook yang masih nonaktif di bagian Integrasi" width="1300" height="1170" data-path="images/integration/webhook/step3.webp" />
    </Frame>

    Akan muncul konfirmasi **Aktifkan Webhook?**. Tekan **OK** (di web) atau **Oke** (di mobile) untuk melanjutkan.
  </Step>

  <Step title="Buka portal webhook">
    Setelah webhook aktif, muncul menu **Kelola Webhook** di bawah toggle. Tekan **Kelola Webhook** untuk membuka portal webhook:

    * Di **web**, portal terbuka di tab baru.
    * Di **mobile**, portal terbuka di browser dalam aplikasi.

    <Frame>
      <img src="https://mintcdn.com/simplus/I4ux79tJi2Xrpq8U/images/integration/webhook/step4.webp?fit=max&auto=format&n=I4ux79tJi2Xrpq8U&q=85&s=34e9b56530035c8dd5d4f6ea7f2c9447" alt="Menu Kelola Webhook setelah toggle Webhook aktif" width="1300" height="1296" data-path="images/integration/webhook/step4.webp" />
    </Frame>

    <Info>
      Link portal berlaku sementara. Kalau portal sudah tertutup atau kedaluwarsa, tekan **Kelola Webhook** lagi.
    </Info>
  </Step>
</Steps>

## Mendaftarkan endpoint di portal

<Steps>
  <Step title="Tambah endpoint">
    Di halaman **Endpoints**, klik **Add Endpoint**.

    <Frame>
      <img src="https://mintcdn.com/simplus/I4ux79tJi2Xrpq8U/images/integration/webhook/portal-1.webp?fit=max&auto=format&n=I4ux79tJi2Xrpq8U&q=85&s=8e4c34e590d526733c94b07c955ff37f" alt="Tombol Add Endpoint di halaman Endpoints portal webhook" width="2560" height="880" data-path="images/integration/webhook/portal-1.webp" />
    </Frame>
  </Step>

  <Step title="Isi URL dan pilih event">
    Isi **Endpoint URL** dengan URL milik sistem kamu, misalnya `https://api.tokocontoh.com/webhooks/simplus`. **Description** boleh dikosongkan.

    Di bagian **Subscribe to events**, centang `sales.persisted`. Kalau tidak memilih event apa pun, endpoint akan menerima semua event (**Receiving all events**).

    Klik **Create** untuk menyimpan endpoint.

    <Frame>
      <img src="https://mintcdn.com/simplus/I4ux79tJi2Xrpq8U/images/integration/webhook/portal-2.webp?fit=max&auto=format&n=I4ux79tJi2Xrpq8U&q=85&s=d717ce8769857eb38918ccc6b86fdd79" alt="Form New Endpoint dengan Endpoint URL terisi, event sales.persisted dicentang, dan tombol Create" width="1760" height="1740" data-path="images/integration/webhook/portal-2.webp" />
    </Frame>

    <Warning>
      Gunakan URL `https`. Endpoint harus bisa diakses dari internet, jadi `localhost` tidak akan bisa menerima pesan.
    </Warning>
  </Step>

  <Step title="Salin Signing Secret">
    Setelah endpoint dibuat, kamu langsung masuk ke halaman detail endpoint. Di kolom kanan, cari **Signing Secret**. Secret-nya tersembunyi, klik ikon mata untuk menampilkannya, lalu salin (diawali `whsec_`). Secret ini dipakai untuk [memverifikasi signature](/integration/webhook/verifikasi-signature).

    <Frame>
      <img src="https://mintcdn.com/simplus/I4ux79tJi2Xrpq8U/images/integration/webhook/portal-3.webp?fit=max&auto=format&n=I4ux79tJi2Xrpq8U&q=85&s=6a83b842f3c990e14ef87389f0d78928" alt="Bagian Signing Secret yang masih tersembunyi di halaman detail endpoint" width="680" height="890" data-path="images/integration/webhook/portal-3.webp" />
    </Frame>

    <Warning>
      Simpan Signing Secret di environment variable, jangan di dalam kode yang dibagikan atau di repository publik.
    </Warning>
  </Step>

  <Step title="Kirim event uji coba">
    Buka tab **Testing**. Di bagian **Send event**, pilih `sales.persisted`. Portal akan menampilkan schema dan contoh payload. Klik **Send Example**, lalu pastikan endpoint kamu menerima pesan dan membalas dengan status `2xx`.

    <Frame>
      <img src="https://mintcdn.com/simplus/I4ux79tJi2Xrpq8U/images/integration/webhook/portal-4.webp?fit=max&auto=format&n=I4ux79tJi2Xrpq8U&q=85&s=2c61d67f59965c604654b2b10d792a91" alt="Tab Testing dengan event sales.persisted dipilih dan tombol Send Example" width="1444" height="2210" data-path="images/integration/webhook/portal-4.webp" />
    </Frame>

    <Note>
      Pesan uji coba yang gagal tidak akan dicoba ulang otomatis.
    </Note>
  </Step>
</Steps>

## Memantau pengiriman

Di halaman endpoint, bagian **Message Attempts** menampilkan setiap percobaan pengiriman ke endpoint kamu:

* **Status pengiriman**: **Succeeded** atau **Failed** untuk setiap percobaan. Pakai filter **All**, **Succeeded**, **Failed**, dan **Canceled** untuk menyaringnya.
* **Replay**: klik ikon di kolom **REPLAY** untuk mengirim ulang pesan secara manual. Pesan yang gagal (selain pesan uji coba) juga akan dicoba ulang otomatis.

<Frame>
  <img src="https://mintcdn.com/simplus/I4ux79tJi2Xrpq8U/images/integration/webhook/portal-5.webp?fit=max&auto=format&n=I4ux79tJi2Xrpq8U&q=85&s=6933943c6fcdf864470abb34f62de03e" alt="Daftar Message Attempts dengan status Failed untuk event sales.persisted" width="2000" height="616" data-path="images/integration/webhook/portal-5.webp" />
</Frame>

Untuk melihat semua pesan dari semua endpoint, buka menu **Logs** di sidebar portal (halaman **Message Logs**).

<Tip>
  Kalau endpoint terus gagal dalam waktu lama, endpoint bisa dinonaktifkan otomatis. Cek log secara berkala dan aktifkan kembali setelah masalahnya diperbaiki.
</Tip>

## Langkah berikutnya

<CardGroup cols={2}>
  <Card title="Menerima Webhook" icon="inbox" href="/integration/webhook/menerima-webhook">
    Buat endpoint penerima, coba di lokal, dan verifikasi setiap pesan.
  </Card>

  <Card title="Event sales.persisted" icon="receipt" href="https://registry.scalar.com/@simplus/apis/public#tag/webhook-overview">
    Lihat contoh payload transaksi penjualan.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.