Webhook URL adalah sebuah URL dari server / sistem anda yang bisa dibuat sebagai destinasi sebuah webhook. Xendit memiliki produk dan fitur yang akan mengirimkan webhook jika ada update / notifikasi pembayaran.

Dengan webhook URL, anda bisa melakukan update ketika ada notifikasi pembayaran, yang webhooknya akan Xendit kirimkan ke webhook URL anda. Anda bisa menambahkan dan testing webhook URL Xendit padal ink berikut ini.

Jika anda memiliki aplikasi / website, maka anda perlu menyiapkan webhook URL yang aktif dan selalu bisa menerima dan memproses webhook anda. Jika webhook URL anda tidak siap atau tidak menerima webhook URL, implikasinya adalah end user anda tidak bisa menerima notifikasi pembayaran yang anda ingin kirimkan sebagai konfirmasi status pembayaran.

Xendit memiliki beberapa alur webhook yang bisa dibuat, seperti berikut ini : 

Money-in

• • invoice: Notifikasi ketika Invoice telah terbayarkan atau kedaluwarsa;
  • Subscription
    • recurring: Xendit akan mengirimkan respon kepada sistem Anda ketika rencana pembayaran berulang di aktif / non-aktif kan, atau percobaan siklus pembayaran sudah dibuat, berhasil, gagal, dan dicoba kembali.
      • Catatan: Pengaturan ini tidak bekerja untuk endpoint /recurring_payments
  • Payments API
    • Payment Request
    • payment_method_v2: Notifikasi ketika Payment Method V2 akan kedaluwarsa atau sudah diaktifkan/kedaluwarsa;
    • Refunds
      • Refund request succeded: Notifikasi ketika refund sukses dilakukan;
      • Refund request failed: Notifikasi ketika refund gagal dilakukan;
  • Cards
    • Otentikasi kartu: Ketika sebuah proses otentikasi kartu selesai, kami akan mengirim notifikasi lewat URL ini kepada Anda;
    • Tokenisasi kartu: Ketika status dari sebuah proses tokenisasi kartu adalah "VERIFIED" atau "FAILED", kami akan mengirim notifikasi lewat URL ini kepada Anda;
  • Direct Debit
    • direct_debit: Notifikasi untuk setiap pembayaran Direct Debit yang berhasil;
    • payment_method: Notifikasi ketika Payment Method akan kedaluwarsa atau sudah kedaluwarsa;
  • ewallet: Tipe eWallet baru dari API/ewallets/chargesuntuk menerima event charged dan event-event lainnya dari semua kanal eWallets;
  • qr_code: Xendit mengirimkan notifikasi ke sistem Anda ketika QR terlah berhasil dibayar atau proses refund telah selesai.
    • Parameter ini hanya berlaku untuk API qr_codes versi 2022-07-31.
  • Fixed Virtual Account
    • fva_status: Notifikasi ketika Virtual Account berhasil dibuat atau diperbaharui;
    • fva_paid: Notifikasi ketika Virtual Account telah berhasil dibayar oleh pelanggan Anda;
  • PayLater
    • PayLater Payment Status: Ketika pembayaran PayLater telah berhasil atau gagal, kami akan mengirim notifikasi ke aplikasi Anda;
  • Retail Outlet
    • ro_fpc_paid: Notifikasi ketika kode pembayaran Alfamart/Indomaret telah berhasil dibayar oleh pelanggan Anda.

Money-Out

• • batch_disbursement: Notifikasi ketika Batch Disbursement telah berhasil dieksekusi. 
  • disbursement: Notifikasi ketika Disbursement telah berhasil dieksekusi, dengan status berhasil atau gagal transfer.

xenPlatform

• • Akun Terbuat: Ketika sebuah akun sudah terbuat, kami akan memberi tahu Anda. Kirim untuk akun OWNED.
  • Akun diperbarui: Ketika sebuah akun sudah teregistrasi atau teraktivasi, kami akan memberi tahu Anda. Kirim untuk akun MANAGED.
  • Suspension Akun: Ketika Akun suspected, suspended atau cleared, kami akan memberikan notifikasi di aplikasi Anda.

Laporan

• • Laporan Balance dan Transaction: aporan Anda akan dikirim ke URL ini

Anda bisa membuat webhook URL spesifik untuk masing-masing produk. Kami juga menyediakan opsi untuk menambahkan webhook URL pada mode Testing dan Live.

Apakah Xendit memiliki contoh Webhook URL?

Kami tidak memiliki webhook URL yang bisa di implementasi langsung pada mode Live.
Untuk testing, anda dapat membuat sebuah Public URL yang anda bisa gunakan sementara melalui website seperti ngrok.io, atau beeceptor.com

Baca lebih lanjut mengenai bagaimana webhook Xendit bekerja pada link berikut ini