Pembayaran Pelanggan
Fitur ini membantu Anda menagih pelanggan Anda sendiri. Anda menghubungkan akun gateway pembayaran milik bisnis Anda, lalu AI atau agen membuat link pembayaran yang bisa dikirim lewat percakapan. Uang dari pelanggan masuk ke akun gateway Anda, bukan ke tumbuh.ai.
Fitur ini berbeda dari pembayaran langganan tumbuh.ai. Untuk biaya langganan dan saldo kredit, lihat Langganan dan Kredit.
Sebelum mulai
- Anda punya akun merchant di salah satu gateway yang tersedia di Pengaturan, yaitu Midtrans atau Prismalink, beserta kredensial dari dashboard gateway tersebut.
- Hanya pemilik bisnis dan admin yang bisa mengubah pengaturan pembayaran. Agen tidak bisa membukanya, tetapi agen tetap bisa membuat link pembayaran dari OneInbox. Lihat Peran dan Agen.
- Bila Anda ingin pelanggan otomatis berpindah tahap setelah membayar, siapkan pipeline dan tahap tujuannya lebih dulu.
- Halaman pengaturan ini memakai label berbahasa Inggris. Label di bawah ditulis persis seperti yang tampil.
Menghubungkan gateway
Buka Pengaturan, lalu pilih Payments. Kartu yang tampil bernama "Payment Gateway".
- Isi Name untuk menamai koneksi ini.
- Pilih Provider: Midtrans atau Prismalink.
- Isi kolom kredensial yang muncul. Kolomnya mengikuti provider yang Anda pilih:
- Midtrans: Environment, Merchant ID (opsional), Server Key, dan Client Key (opsional).
- Prismalink: Environment, Integration mode, Merchant ID, Merchant Key ID, dan Merchant Secret Key.
- Atur aturan pembayaran:
- Expiry minutes: masa berlaku link, minimal 5 menit. Nilai awalnya 5.
- Min amount dan Max amount: batas nominal per pembayaran. Nilai awalnya 1.000 dan 100.000.000.
- Pilih kanal pembayaran (lihat bagian berikutnya).
- Pilih Paid pipeline dan Paid stage (lihat bagian setelahnya).
- Salin Callback URL dari kolom yang hanya bisa dibaca, lalu pasang di dashboard gateway Anda. Tanpa ini, status pembayaran dari gateway tidak sampai ke tumbuh.ai.
- Klik Save.
- Klik Test connection dan tunggu pesan hasilnya.
- Nyalakan sakelar Enable customer payments, lalu klik Save lagi.
Gunakan Environment Sandbox untuk uji coba dan Production untuk transaksi sungguhan. Kredensial bersifat rahasia. Jangan membagikannya di percakapan atau tangkapan layar. Setelah disimpan, kolom rahasia hanya menampilkan versi tersamar.
Tombol Test connection baru aktif setelah koneksi pernah disimpan.
Metode dan kanal pembayaran
Pilihan kanal bergantung pada provider:
- Midtrans: centang satu atau lebih kanal, misalnya QRIS, GoPay, ShopeePay, transfer bank/VA, kartu kredit, atau gerai ritel.
- Prismalink: pilih satu pilihan pada Payment channel, yaitu All methods atau satu jenis (Virtual Account, Credit Card, Direct Debit, atau QRIS). Prismalink tidak menerima gabungan beberapa jenis.
- Prismalink Integration mode: Hosted Payment Page membuka halaman pembayaran milik Prismalink. Full API QRIS menampilkan kode QRIS di halaman pembayaran tumbuh.ai, dan kanal otomatis terkunci ke QRIS.
Tahap setelah lunas (Paid pipeline dan Paid stage)
Saat gateway menyatakan pembayaran lunas, pelanggan dapat dipindahkan otomatis ke tahap CRM tertentu.
- Pilih Paid pipeline, lalu Paid stage.
- Pilih Do not move customer after paid bila Anda tidak ingin pelanggan dipindahkan.
Mengizinkan alur kerja AI membuat link
Sakelar Enable customer payments mengaktifkan fitur ini. Keterangan di bawahnya: "AI workflows can create customer payment links when enabled". Bila sakelar mati, link pembayaran tidak bisa dibuat. Pengaturan alat pembayaran di Alur Kerja dijelaskan di Alur Kerja.
Mengganti provider
Hanya satu koneksi yang boleh aktif dalam satu waktu. Saat Anda mengganti Provider pada koneksi yang sudah ada, aplikasi menampilkan konfirmasi.
- Koneksi lama dipensiunkan tetapi tidak dihapus, sehingga link yang sudah terkirim tetap bisa dibayar.
- Masa berlaku, batas nominal, dan Paid stage dibawa ke koneksi baru.
- Provider baru tetap nonaktif sampai Test connection berhasil.
Koneksi tidak bisa dihapus selama masih ada link berstatus PENDING.
Membuat link pembayaran dari OneInbox
Siapa pun yang bisa membalas percakapan, termasuk agen, dapat membuat link.
- Buka percakapan di OneInbox.
- Klik ikon kartu Buat link payment di kolom pengetik pesan. Ikon nonaktif bila pelanggan atau percakapan belum siap.
- Isi dialog Buat Link Payment:
- Nominal IDR: harus lebih dari 0.
- Payment channel: tampil bila gateway Anda mendukung pilihan kanal. Biarkan Ikuti default settings untuk memakai pengaturan di halaman Payments.
- Deskripsi: wajib diisi, misalnya konsultasi atau pembelian produk.
- Expiry menit (opsional): minimal 5. Kosongkan untuk memakai nilai bawaan.
- Klik Buat link pembayaran.
Pesan draf berisi deskripsi, nominal, Order ID, batas waktu, dan link, lalu dimasukkan ke kolom pesan. Periksa isinya, lalu kirim sendiri. Notifikasi "Draft pesan sudah dimasukkan ke composer" muncul saat berhasil. Dialog ini berbahasa Indonesia.
Bila gagal, dialog menampilkan pesan, misalnya karena koneksi belum aktif atau nominal di luar batas yang Anda atur.
Yang dilihat pelanggan
Tampilan bergantung pada gateway dan mode integrasi Anda.
Halaman pembayaran QRIS dari tumbuh.ai
Pada Prismalink mode Full API QRIS, link yang diterima pelanggan berbentuk <domain-anda>/p/<token> dan membuka halaman berjudul "QRIS Payment". Halaman ini menampilkan:
- Status: Pending, Paid, Expired, atau Failed, beserta penjelasan singkat.
- Amount: nominal pembayaran.
- Kode QRIS yang bisa dipindai dengan e-wallet atau mobile banking, hanya selama status Pending.
- Expires in: hitung mundur menit dan detik.
Halaman memeriksa status secara berkala. Saat pembayaran diterima, tampilannya berubah menjadi Paid tanpa perlu dimuat ulang. Bila hitung mundur habis, tampilan berubah menjadi Expired. Pelanggan diminta meminta link baru ke Anda.
Bila link tidak valid atau sudah tidak tersedia, halaman menampilkan "Payment page unavailable" dengan keterangan "The link is invalid or no longer available."
Halaman gateway
Pada Midtrans dan Prismalink Hosted Payment Page, link membuka halaman pembayaran milik gateway. Pelanggan memilih metode di sana.
Halaman hasil
Setelah pelanggan selesai di halaman gateway, mereka dikembalikan ke salah satu halaman hasil. Halaman ini juga menampilkan Order ID.
| Halaman | Judul | Arti bagi pelanggan |
|---|---|---|
| Berhasil | "Payment received" | Pembayaran diterima dan sedang dikonfirmasi. |
| Menunggu | "Payment pending" | Pembayaran belum selesai. Bila sudah membayar, konfirmasi mungkin butuh waktu. |
| Gagal | "Payment failed" | Pembayaran tidak selesai. Pelanggan bisa mencoba lagi dari link atau meminta link baru. |
Halaman hasil hanya informasi untuk pelanggan. Status resmi di tumbuh.ai mengikuti konfirmasi dari gateway.
Memantau pembayaran
Buka detail pelanggan di Pelanggan, lalu tab Payments. Setiap pembayaran ditampilkan sebagai kartu berisi deskripsi, nominal, dan lencana status. Detail yang tersedia: Provider, Source, Created, Expires, Paid, Order, Reference, dan Callback proof (Received atau Not received). Bagian Timeline mencatat kejadian pembayaran.
Aksi pada tiap kartu:
| Aksi | Kapan tersedia |
|---|---|
| Copy link dan Open | Bila link pembayaran ada. |
| Resend | Hanya untuk pembayaran PENDING. |
| Check status | Untuk pembayaran yang belum PAID. Menanyakan status terbaru langsung ke gateway. |
| Copy proof | Hanya untuk pembayaran PAID. Menyalin ringkasan bukti pembayaran. |
Status PAID juga memicu perpindahan ke Paid stage bila Anda mengaturnya.
Hasil yang diharapkan
- Test connection berhasil dan Enable customer payments menyala.
- Link pembayaran dari OneInbox atau AI sampai ke pelanggan.
- Setelah pelanggan membayar, status berubah menjadi PAID dan pelanggan pindah ke Paid stage.
Masalah umum
Pelanggan sudah bayar, tetapi status masih Pending. Buka tab Payments pada detail pelanggan dan klik Check status. Bila Callback proof menunjukkan Not received, pastikan Callback URL sudah terpasang di dashboard gateway.
Test connection gagal. Periksa Environment dan kredensial. Pesan dari gateway ditampilkan apa adanya. Pada Prismalink, pesan tertentu dapat menunjukkan Secret Key yang salah atau alamat IP server yang belum didaftarkan di portal merchant.
Link tidak bisa dibuat. Pastikan Enable customer payments menyala dan nominal berada di antara Min amount dan Max amount.
Pelanggan melihat "Payment page unavailable". Link tidak valid atau sudah tidak tersedia. Buat link baru dan kirim ulang.
Tidak ada menu Payments. Menu ini hanya untuk pemilik bisnis dan admin.