Deposit & Pembayaran

Aktif

Konfigurasi deposit per layanan dan alur pembayaran Termilo. Deposit dibayar lewat gateway pembayaran yang dihubungkan bisnis sendiri (BYOK); dana masuk langsung ke rekening bisnis.

Lihat .md
Deposit dan pembayarannya live lewat gateway pembayaran milik bisnis (BYOK). Yang tidak tersedia: event webhook untuk pembayaran (payment.*) — webhook booking hanya mencakup status booking.

Status fitur#

Supaya tidak ada ekspektasi yang keliru, berikut pembagian yang jujur antara yang sudah jalan dan yang tidak tersedia.

KemampuanStatusCatatan
Konfigurasi deposit per layananAktifPersen + harga di Service editor.
Toggle deposit globalAktifPengaturan → Notifikasi → "Minta deposit".
Pembayaran deposit lewat gateway BYOKAktifDana masuk langsung ke rekening bisnis.
Event payment.*Tidak tersediaLihat bagian Event pembayaran.

Bagaimana deposit dimodelkan#

Deposit adalah kebijakan per layanan: tanpa deposit, nominal tetap, atau persentase dari harga layanan. Bisnis mengatur pilihannya di editor layanan; pembayarannya diproses lewat gateway pembayaran yang dihubungkan bisnis sendiri.

PARAMETERTIPEWAJIBKETERANGAN
price_amountinteger · nullopsionalHarga layanan dalam satuan terkecil (minor units, mis. rupiah penuh). Boleh null untuk layanan gratis.
price_currencystringopsionalKode mata uang, mis. "IDR". Mendampingi price_amount.
statusenumwajibactive | hidden | disabled — menentukan apakah layanan bisa dibooking.

Mengatur deposit berarti mengatur harga layanan lewat POST /api/services (memerlukan sesi dashboard + header CSRF X-Termilo-CSRF). Persentase deposit dihitung dari priceAmount di sisi UI; respons layanan tidak mengandung field tagihan apa pun.

# Deposit = konfigurasi harga layanan. Tidak ada endpoint charge. curl https://api.termilo.id/api/services \ -H "Authorization: Bearer $TOKEN" \ -H "X-Termilo-CSRF: $CSRF" \ -d '{ "slug": "konsultasi-30", "name": "Konsultasi 30 menit", "durationMin": 30, "priceAmount": 200000, "priceCurrency": "IDR" }'
201 Createdapplication/json
{
"serviceId": "svc_8f2a",
"slug": "konsultasi-30",
"priceAmount": 200000,
"priceCurrency": "IDR",
"status": "active"
}
Naming
Dalam standar penamaan Termilo, layanan disebut event type, tetapi di skema dan admin API resource-nya bernama services. price_amount memakai satuan terkecil (minor units) dan boleh null untuk layanan gratis.

Aktifkan deposit per layanan#

Di Service editor, bagian Harga & deposit punya switch "Minta deposit" dengan tiga preset persen. Saat aktif, UI menghitung nominal deposit dari harga total.

  1. Dashboard → Katalog → Layanan → buka layanan.
  2. Isi Harga (Rp) — ini yang memetakan ke priceAmount.
  3. Nyalakan "Minta deposit", lalu pilih persentase:20%30%50%
  4. Simpan. Booking layanan ini akan menampilkan nominal deposit ke pelanggan saat checkout.
Pembayaran deposit memindahkan status booking
Booking dengan deposit lahir sebagai held dan slot ditahan 10 menit. Begitu deposit dibayar lewat gateway bisnis, booking berpindah ke confirmed; bila 10 menit lewat tanpa pembayaran, hold kedaluwarsa dan slot dilepas.

Toggle deposit global#

Selain per layanan, ada switch global di Pengaturan → Notifikasi → "Minta deposit" dengan deskripsi "Wajibkan deposit untuk mengunci slot saat booking dibuat." Gunakan ini sebagai kebijakan default untuk seluruh layanan.

Toggle ini mengatur kebijakan bawaan ("minta deposit") untuk layanan yang tidak diatur sendiri-sendiri; slot tetap ditahan sampai pembayaran deposit masuk lewat gateway bisnis.

Pengalaman checkout#

Halaman /checkout/:slug? menampilkan ringkasan deposit dan pilihan metode pembayaran. Bila layanan tidak menetapkan persentase eksplisit, halaman ini memakai default 30% dari harga.

QRISInstan

Scan dengan e-wallet atau m-banking apa pun.

Transfer bank

Virtual account BCA, BRI, Mandiri, BNI.

Kartu kredit

Visa, Mastercard, JCB.

Pembayaran diproses lewat gateway bisnis
Pembayaran deposit masuk langsung ke rekening bisnis lewat gateway pembayaran yang dihubungkan bisnis sendiri (BYOK). Termilo tidak pernah menahan dana pelanggan.

Event pembayaran#

Tidak tersedia

Webhook booking mencakup status booking saja. Deposit tidak punya event webhook tersendiri; nama berikut tidak dipancarkan:

EVENTSTATUSKETERANGAN
payment.deposit_paidwebhookopsionalTidak tersedia.
payment.failedwebhookopsionalTidak tersedia.
Pantau status booking, bukan event pembayaran
Untuk mengetahui deposit sudah masuk, pantau transisi held → confirmed lewat event booking.confirmed. Lihat panduan Webhooks untuk daftar event booking yang tersedia.

Pertanyaan umum#

Ya. Bisnis meminta deposit per layanan — tanpa deposit, nominal tetap, atau persentase — dan pelanggan membayarnya lewat gateway pembayaran yang dihubungkan bisnis sendiri (BYOK). Dana masuk langsung ke rekening bisnis, bukan ke Termilo.

← Sebelumnya
Lifecycle booking
Berikutnya →
Booking grup & kelas

Dipakai untuk

Diperbarui 12 September 2026