Untuk menerima pembayaran secara otomatis, ChatMo terintegrasi dengan Xendit — payment gateway yang mendukung Virtual Account, QRIS, Kartu Kredit/Debit, e-wallet, dan gerai retail. Setelah terhubung, AI agent bisa membuat link pembayaran asli untuk setiap pesanan, dan status pesanan/pembayaran otomatis terupdate saat pelanggan membayar.
Semua ini dikelola dari menu Payment di sidebar Pesanan (Pesanan → Payment).
Dua cara menghubungkan Xendit
ChatMo mendukung dua jenis integrasi. Pilih yang sesuai dengan kondisi Anda:
| Jenis | Cocok untuk | Cara kerja |
|---|---|---|
| Buat lewat ChatMo (sub-account xenPlatform) | Belum punya akun Xendit | ChatMo membuatkan sub-account Xendit untuk Anda. Verifikasi via email + selesaikan KYC Xendit. ChatMo mengelola key & webhook untuk Anda. |
| Hubungkan akun sendiri (self-managed) | Sudah punya akun Xendit | Anda memasukkan Business ID, Secret Key, dan Webhook Token milik sendiri. ChatMo memakai akun Anda secara langsung. |
Kedua jenis ini sepenuhnya terpisah dari Manual Payment (transfer bank), yang tetap bisa Anda atur kapan pun.
Opsi A — Buat lewat ChatMo (xenPlatform)
Pilih ini jika Anda belum punya akun Xendit. ChatMo akan membuat dan mengelola sub-account Xendit atas nama Anda.
- Buka
Pesanan → Paymentlalu klik Buat lewat ChatMo. - Masukkan email dan nama bisnis, lalu klik Kirim Kode Verifikasi.
- Masukkan kode 6 digit yang dikirim ke email Anda.
- ChatMo membuat sub-account Xendit Anda. Anda akan menerima email undangan dari Xendit untuk menyelesaikan verifikasi KYC.
- Setelah KYC disetujui Xendit, status akun menjadi Active dan Anda bisa mulai menerima pembayaran otomatis.
Review KYC dilakukan oleh Xendit dan bisa memakan waktu. Anda tetap bisa memakai Manual Payment sambil menunggu. Untuk jenis akun ini, ChatMo otomatis mengatur webhook pembayaran & payout — tidak ada yang perlu Anda konfigurasi lagi.
Opsi B — Hubungkan akun Xendit Anda sendiri (self-managed)
Pilih ini jika Anda sudah punya akun Xendit. Anda tetap memegang kendali penuh atas akun; ChatMo hanya memakai kredensial Anda untuk membuat invoice dan membaca saldo.
Yang perlu disiapkan
Dari dashboard Xendit, kumpulkan empat hal berikut (bagian selanjutnya menunjukkan persis di mana letak masing-masing):
| Field | Penjelasan |
|---|---|
| Business ID | ID akun / bisnis Xendit Anda |
| Secret API Key | Key diawali xnd_... dengan permission yang tepat |
| Webhook Verification Token | Token yang dipakai Xendit menandatangani webhook |
| IP Allowlist (jika diaktifkan) | Tambahkan IP server ChatMo agar request kami tidak diblokir |
Cara mengambil kredensial Xendit
Bagian ini memandu persis di mana letak setiap nilai di Dashboard Xendit (dashboard.xendit.co).
1. Business ID
Business ID mengidentifikasi akun Xendit Anda.
- Login ke Dashboard Xendit lalu buka halaman Settings (dashboard.xendit.co/settings).
- Pilih menu Your Business (dashboard.xendit.co/settings/business-profile#business).
- Salin Business ID.
2. Generate Secret Key
Buat API key dengan permission yang benar agar ChatMo bisa membuat invoice, mengirim payout, serta membaca saldo/transaksi.
- Di Dashboard Xendit, buka Settings → Developers → API Keys.
- Klik Generate Secret Key (atau Create API Key).
- Atur permission persis seperti di bawah ini:
| Produk | Permission |
|---|---|
| Money-in products | Write |
| Money-out products | Write |
| Balance | Read |
| Transaction | Read |
- Generate key-nya lalu segera salin — Xendit hanya menampilkan secret key penuh sekali. Key diawali
xnd_.
Secret key hanya ditampilkan sekali saat dibuat. Segera salin. Jika hilang, generate baru (lalu hubungkan ulang di ChatMo). Jangan pernah membagikan key ini ke publik.
3. Webhook Verification Token
Token ini membuat ChatMo bisa memverifikasi bahwa webhook yang masuk benar-benar dari akun Xendit Anda.
- Di Dashboard Xendit, buka Settings → Developers → Webhooks.
- Temukan Webhook Verification Token lalu salin.
4. IP Allowlist (hanya jika Anda mengaktifkannya)
Jika Anda mengaktifkan IP Allowlist di Xendit (Settings → Security → IP Allowlist), Xendit akan memblokir panggilan API dari IP yang tidak ada di daftar. Tambahkan IP server ChatMo agar request kami tidak diblokir:
Code
Jika Anda tidak memakai IP Allowlist, langkah ini bisa dilewati. Jika memakainya tapi lupa menambahkan IP ini, panggilan invoice/payout/saldo ChatMo akan gagal dengan error otorisasi.
Langkah menghubungkan di ChatMo
Setelah kredensial siap:
- Buka
Pesanan → Paymentlalu klik Hubungkan akun sendiri. - Isi Business ID, Secret API Key, Webhook Verification Token, dan Admin Fee (opsional).
- Klik Continue dan konfirmasi dengan authenticator app (2FA).
Lalu ChatMo akan:
- Memvalidasi format key Anda.
- Live-test Secret Key ke Xendit (panggilan API asli). Jika key tidak valid, koneksi ditolak.
- Mendaftarkan URL webhook ChatMo ke akun Xendit Anda secara otomatis.
- Mengenkripsi dan menyimpan kredensial Anda, lalu menandai akun Active.
Menghubungkan (juga reconfigure/disconnect) memerlukan two-factor authentication (2FA). Aktifkan 2FA dulu di Settings → Security kalau belum.
Menghubungkan akun akan mengatur URL webhook invoice & payout pada akun Xendit Anda, menggantikan URL webhook yang sudah ada untuk event tersebut. Jika webhook itu Anda pakai untuk sistem lain, set URL ChatMo secara manual saja (lihat di bawah).
URL Webhook
ChatMo perlu diberi tahu Xendit saat invoice dibayar dan saat payout selesai. Berikut URL-nya (juga ditampilkan pada form):
| Event | URL Webhook |
|---|---|
| Payment (invoice dibayar / kedaluwarsa) | https://api.chatmo.io/v1/xendit/account/payment/webhook |
| Payout (penarikan berhasil / gagal) | https://api.chatmo.io/v1/xendit/account/payout/webhook |
Jika ChatMo gagal mengatur webhook secara otomatis (akan muncul pemberitahuan), tambahkan secara manual di Xendit → Settings → Webhooks untuk event terkait.
Keamanan: bagaimana key Anda disimpan
Secret Key dan Webhook Token Anda terenkripsi saat disimpan — tidak pernah disimpan dalam bentuk teks biasa. Setelah disimpan, ChatMo hanya menampilkan pratinjau yang di-masking (mis. xnd_…cdef); nilai lengkapnya tidak bisa dibaca ulang dari dashboard.
Admin Fee, jika diisi, ditambahkan sebagai baris biaya terpisah pada setiap invoice Xendit dan ditagihkan ke pelanggan di atas total pesanan.
Reconfigure koneksi Anda
Perlu mengganti Secret Key, memperbarui Webhook Token, atau mengubah Admin Fee? Gunakan Reconfigure:
- Di halaman Payment (akun self-managed), klik Reconfigure.
- Perbarui field-nya. Key Anda saat ini ditampilkan ter-masking sebagai referensi — masukkan ulang nilai yang ingin diganti.
- Klik Continue dan konfirmasi dengan 2FA.
Disconnect akun Xendit Anda
Jika ingin berhenti memakai akun Xendit yang terhubung, Anda bisa men-disconnect kapan saja.
- Di halaman Payment (akun self-managed), klik Disconnect.
- Konfirmasi pada dialog, lalu verifikasi dengan 2FA.
Yang terjadi saat disconnect:
- Pembayaran otomatis berhenti sampai Anda menghubungkan kembali.
- Key Xendit Anda yang tersimpan dihapus dari ChatMo (kredensial terenkripsi dihapus).
- Akun Xendit Anda sendiri tidak terpengaruh — hanya tautan ke ChatMo yang dihapus. URL webhook yang Anda set di Xendit tetap ada; bisa Anda hapus sendiri dari dashboard Xendit jika mau.
Anda bisa menghubungkan kembali kapan saja melalui Hubungkan akun sendiri lagi. Disconnect sepenuhnya reversible.
Setelah terhubung
Setelah akun Active:
- AI agent bisa membuat invoice Xendit asli untuk pesanan yang memakai pembayaran Automatic (Xendit).
- Saat pelanggan membayar, status pembayaran pesanan otomatis menjadi Paid dan pelanggan menerima pesan konfirmasi di chat.
- Saldo Xendit live Anda muncul di halaman
Pesanan → Balance, tempat Anda juga bisa mengajukan penarikan ke rekening bank.
Langkah Selanjutnya
- Manajemen Pesanan — kelola pesanan, status, dan pembatalan.
- Invoice — kustomisasi template invoice.
- Ringkasan — gambaran besar sistem pesanan.