Terima notifikasi real-time dari Mutasiku ke endpoint aplikasi Anda.
Webhook dikirim sebagai HTTP POST dari server Mutasiku ke URL endpoint Anda. Daftarkan endpoint di dashboard → Integrasi → Webhooks.
Setup
Daftarkan webhook di dashboard
Buka Integrasi → Webhooks di dashboard, klik Tambah Webhook, dan masukkan URL endpoint Anda. URL harus domain publik dengan http:// atau https:// — localhost dan alamat IP ditolak.
Secara default webhook menerima event dari semua akun Anda. Anda bisa membatasinya ke akun tertentu lewat pilihan Akun pada webhook tersebut.
Pilih events yang ingin diterima
Pilih event spesifik atau subscribe ke semua event.
Implementasikan verifikasi signature
Verifikasi header X-Webhook-Signature di setiap request masuk. Lihat bagian Security di bawah.
Test webhook Anda
Gunakan fitur test di dashboard untuk mengirim event percobaan ke endpoint Anda.
Available Events
Account Events
| Event | Keterangan |
|---|---|
account.created | Akun baru dibuat |
account.updated | Detail akun diperbarui |
Payload account.created
Payload account.updated
Mutations Events
| Event | Keterangan |
|---|---|
mutations.created | Mutasi/transaksi baru terdeteksi |
balance.updated | Saldo akun berubah |
Payload mutations.created
Payload balance.updated
Payment Events
| Event | Keterangan |
|---|---|
payment.created | Pembayaran baru dibuat |
payment.completed | Pembayaran berhasil |
Pembayaran yang kadaluarsa atau gagal tidak dikirim sebagai webhook. Untuk
memastikannya, cek status pembayaran —
tagihan yang belum COMPLETED setelah expiresAt berstatus EXPIRED.
Payload payment.created
uniqueCode bernilai null bila metodenya belum dipilih pembeli. Untuk pembayaran ke akun sendiri, payload juga berisi ewallet (nama provider, nomor, dan nama akun penerima).
Payload payment.completed
Transaksi Payment Gateway tidak dikirim ke webhook yang Anda buat sendiri. Event-nya dikirim ke webhook Payment Gateway — dibuat otomatis dari URL webhook yang disetujui admin, dan tampil di daftar webhook dengan label Payment Gateway. URL webhook itu tidak bisa diubah langsung; ajukan perubahannya dari dashboard → Payment Gateway → Integrasi.
Security — Verifikasi Signature
Selalu verifikasi X-Webhook-Signature sebelum memproses payload. Abaikan
request tanpa signature valid untuk mencegah pemalsuan event.
Signature dibuat menggunakan HMAC-SHA256 dengan secret webhook Anda sebagai key dan field data (JSON string) sebagai message.
Node.js
PHP
Python
Best Practices
Kembalikan 2xx segera. Jangan tunggu proses selesai — kirim respons 200
lebih dulu, lalu proses event secara asinkron dengan queue/job. Jika endpoint
tidak merespons dalam 30 detik, Mutasiku akan retry.
Idempotent handler. Event yang sama bisa dikirim lebih dari sekali.
Gunakan ID pembayaran dari payload (paymentRequestId pada
payment.completed) sebagai idempotency key untuk mencegah proses duplikat.
Simpan raw payload. Log seluruh payload yang masuk untuk keperluan debugging dan audit.
Troubleshooting
| Masalah | Solusi |
|---|---|
| Webhook tidak diterima | Pastikan URL endpoint dapat diakses dari internet (bukan localhost) |
| Signature tidak valid | Gunakan JSON.stringify(payload.data), bukan seluruh payload |
| Timeout | Kembalikan 200 segera, proses logic secara asinkron |
| Event duplikat | Implementasikan idempotency key menggunakan ID pembayaran di payload |
| Transaksi gateway tidak masuk | Event Payment Gateway hanya dikirim ke webhook Payment Gateway, bukan webhook buatan Anda |
© 2026 PT. Cobra Code Indonesia. All rights reserved.
Last updated: 11/10/2026