Mengelola webhook xenPlatform

Prev Next

Anda dapat mengintegrasikan webhook untuk menerima pemberitahuan real-time tentang peristiwa yang terkait dengan Anda Account Holders di xenPlatform. Webhook ini memungkinkan sistem Anda merespons berbagai perubahan status secara otomatis.

Sebelum memulai: Pastikan Anda telah mengatur URL webhook Anda untuk xenPlatform - Pemegang Akun. Lihat panduan atau API kami untuk petunjuk tentang cara mengatur URL webhook Anda.

Event webhook

Trigger

Deskripsi

Verifikasi KYC berhasil account_holder.kyc.status:passed

Ketika Xendit memutuskan bahwa informasi Account Holder cukup untuk verifikasi sub-akun

Gunakan event ini untuk memberi tahu merchant Anda bahwa Akun mereka telah lulus verifikasi KYC dari Xendit

Verifikasi KYC gagal account_holder.kyc.status:failed

Ketika Xendit memutuskan bahwa Account Holder tidak memiliki informasi yang cukup untuk sub-akun

Gunakan event ini untuk memberi tahu merchant Anda bahwa orientasi mereka ditolak oleh Platform Xendit juga dapat menggunakan failure_reason untuk memberi tahu Mitra mereka alasan mengapa pengiriman mereka gagal

Pengiriman ulang dokumen yang diperlukan account_holder.kyc.status:resubmission_required

Ketika Xendit memerlukan dokumen tambahan

Gunakan event ini untuk memberi tahu merchant Anda bahwa informasi orientasi mereka tidak valid dan perlu dikirimkan ulang dokumen Kami juga akan memberi tahu Anda melalui webhook dan menentukan bidang yang tidak valid sehingga merchant Anda dapat memperbarui bidang yang tidak valid dengan informasi yang benar

Kapabilitas telah diaktifkan account_holder.capabilities.status:live

Ketika kapabilitas telah diaktifkan untuk sub-akun

Gunakan event ini untuk memberi tahu merchant Anda bahwa kabilitas atau channel pembayaran yang diminta telah diaktifkan untuk sub-akun.

Request aktivasi kapabilitas telah ditolak account_holder.capabilities.status:declined

Ketika kapabilitas telah ditolak untuk sub-akun dan Anda tidak dapat lagi mengirimkan ulang dokumen

Gunakan event ini untuk memberi tahu merchant Anda bahwa permintaan aktivasi mereka ditolak oleh Xendit. Ini failure_reason menjelaskan alasan mengapa penyerahan mereka ditolak.

Aktivasi kapabilitasmemerlukan pengiriman ulang dokumen account_holder.capabilities.status:resubmission_required

Ketika Xendit meminta dokumen tambahan sehingga Anda dapat mengirimkan kembali informasi yang benar untuk mengaktifkan kapabilitas tertentu

Gunakan event ini untuk memberi tahu merchant Anda bahwa informasi mereka tidak valid dan perlu dikirimkan ulang. Bidang tidak valid yang perlu diperbarui ditentukan di webhook.

simulasikan skenario webhook dalam Mode Tes

Anda dapat menggunakan Account Holder ID berikut sebagai magic number untuk mensimulasikan respons API untuk skenario webhook yang berbeda.

Skenario

Account Holder iD

Endpoint

Verifikasi KYC akun berhasil

00000000-0000-0000-0000-000000000000

PATCH v2/akun/:id

Verifikasi KYC akun gagal

00000000-0000-0000-0000-111111111111

PATCH v2/akun/:id

KYC sub-kun membutuhkan pengiriman ulang dokumen

00000000-0000-0000-0000-222222222222

PATCH v2/akun/:id

Kapabilitas telah diaktifkan

00000000-0000-0000-0000-333333333333

PATCH account_holders/:id

Request aktivasi kapabilitas telah ditolak

00000000-0000-0000-0000-444444444444

PATCH account_holders/:id

Aktivasi kapabilitas memerlukan pengiriman ulang dokumen

00000000-0000-0000-0000-555555555555

PATCH account_holders/:id