Artikel berikut bersifat teknis, silahkan konsultasikan ke tim IT dari masing-masing lembaga
Webhook adalah fitur yang berfungsi untuk mengirimkan umpan balik pada url yang telah ditentukan saat ada donasi masuk, yang nantinya dapat diolah kembali oleh developer untuk kepentingan lembaganya masing-masing.
Sebagai contoh, webhook bisa digunakan untuk pengecekan apakah donatur sudah berdonasi pada suatu program atau belum, atau bisa juga untuk menampilkan feed live donasi.
Mengatur URL Webhook
Pengaturan webhook dapat ditemukan di halaman pengaturan lembaga. Silakan isi input webhook dengan URL yang telah anda siapkan untuk memroses umpan balik dari Amalsholeh.
Setelah input URL webhook diisi, klik tombol simpan untuk menyimpan pengaturan.
Webhook data
Webhook akan dijalankan setiap kali ada donasi sukses masuk. Amalsholeh akan melakukan POST Request ke URL yang telah ditentukan dengan data request sebagai berikut:
{
"type": "donation",
"data": {
"donation": {
"invoice_id": "INV-22080500001",
"invoice_code": "23HkJy",
"amount": 50000,
"unique_code": 2,
"total": 50002,
"program": {
"id": 342,
"name": "Sedekah Subuh",
"slug": "beramalsubuh"
},
"fee_gateway": 300,
"fee_admin": 2485,
"net_amount": 47515,
"payment_at": "2022-08-05T06:19:32.320Z"
},
"user": {
"name": "Hamba Allah",
"email": "hambaallah@amalsholeh.com",
"phone": "6281234567890",
"message": "Donatur message"
}
},
"t": "2022-08-05T06:19:32.320Z"
}
Beberapa nilai, seperti nama, email, nomor telepon akan disesuikan dengan preferensi donatur ketika berdonasi. Jika donatur memilih tidak ingin dihubungi maka data nomor telepon akan bernilai null.
Contoh Penggunaan Webhook
Registrasi Event dengan Donasi
Misalkan anda akan mengadakan event kajian, dan untuk mengikuti event tersebut, peserta harus melakukan sedekah terlebih dahulu. Maka anda dapat menggunakan webhook untuk mengetahui apakah donatur telah bersedekah atau belum dan memberikan akses ke event kajian tersebut.
Live Feed Donasi
Karena webhook akan dijalankan setiap donasi sukses masuk, maka event ini bersifat realtime. Penerapan untuk live feed donasi bisa menggunakan fitur ini. Berikut adalah contoh penggunaan live donasi yang kita gunakan di beberapa event.