Integrasi
Hubungkan akun payment gateway, kurir, WhatsApp, email, dan analitik milik Anda sendiri, lengkap dengan tautan daftar, tautan dasbor, nilai yang dibutuhkan, dan URL yang harus ditempel untuk tiap penyedia.
Integrasi menghubungkan Bakasir dengan akun milik Anda di perusahaan lain. Uang, pesan, dan pengiriman berjalan lewat akun Anda sendiri, jadi Bakasir tidak pernah memegang pembayaran pelanggan Anda. Halaman ini menjelaskan fungsi tiap integrasi, apakah Anda memerlukannya, dan cara menyiapkannya langkah demi langkah. Setiap bagian penyedia dimulai dengan tautan yang Anda perlukan (daftar, dasbor, panduan resmi penyedia, harga), jadi Anda tidak perlu mencarinya sendiri.
Sebelum mulai
- Anda adalah Owner. Manager bisa membuka halaman ini tetapi hanya untuk dilihat.
- Buka Pengaturan → Integrasi. Setiap kartu menampilkan statusnya (Terhubung, Belum terhubung, atau Tersimpan, belum diverifikasi), fungsinya, dan tautan Baca panduan ke bagian yang sesuai di bawah.
- Nilai rahasia (server key, kata sandi, token) tidak pernah ditampilkan lagi setelah disimpan. Kosongkan isian rahasia untuk mempertahankan nilai yang tersimpan.
- Buka dua tab browser: Bakasir di satu tab, dasbor penyedia di tab lain. Anda akan menyalin nilai bolak-balik.
- Pakai Sandbox atau mode uji coba lebih dulu. Pindah ke produksi hanya setelah pesanan uji berhasil.
- Nama menu di dasbor penyedia kadang berubah. Jika menu tidak ada di tempat yang disebut halaman ini, cari nama isiannya di dasbor, atau buka panduan penyedia yang ditautkan di bagian terkait.
Fungsi tiap integrasi
| Integrasi | Fitur yang bergantung padanya | Perlu dihubungkan? | Waktu penyiapan |
|---|---|---|---|
| Midtrans | Checkout toko online, DP reservasi, pesan mandiri, dan QRIS di POS. | Hubungkan Midtrans atau DOKU untuk menerima pembayaran digital. | 15 menit untuk Sandbox, ditambah peninjauan penyedia untuk Produksi |
| DOKU | Alur yang sama seperti Midtrans, dengan DANA, OVO, dan e-wallet lain. | Hubungkan DOKU atau Midtrans. | 20 menit untuk Sandbox, ditambah peninjauan penyedia untuk Produksi |
| Biteship | Tarif kurir langsung saat checkout, pengiriman dan resi dari pesanan. | Hanya untuk plugin Shipping. | 20 menit, ditambah aktivasi live dari Biteship |
| Struk, pesanan pembelian, kabar pesanan online, dan pengingat reservasi dari nomor Anda sendiri. | Opsional. Tanpa ini, Bakasir membuka tautan chat WhatsApp untuk Anda kirim manual. | 30 menit, ditambah persetujuan template oleh Meta (hingga 24 jam) | |
| SMTP | Email uji coba dari server surat Anda sendiri. Bakasir belum mengirim struk atau notifikasi lewat server ini. | Opsional, dan belum ada fitur lain yang memakainya. | 10 menit |
| Twilio | Menyimpan dan memeriksa kunci Twilio Anda. Bakasir belum mengirim SMS. | Opsional, dan belum ada fitur lain yang memakainya. | 10 menit |
| Google Analytics | Statistik kunjungan toko online Anda. | Opsional. | 5 menit |
Paket dan mata uang untuk pembayaran
Midtrans dan DOKU menagih pelanggan Anda hanya pada paket Mulai atau lebih tinggi, dan hanya untuk toko yang berjualan dalam IDR. Pada paket Gratis, kartunya bisa diisi, tetapi checkout tidak menawarkan pembayaran digital.
Struk lewat email tidak memakai kartu SMTP
Tombol Resi via Email pada penjualan atau pesanan online mengirim lewat server surat milik instalasi Bakasir itu sendiri, bukan lewat kartu SMTP di halaman ini. Kartu SMTP adalah koneksi terpisah ke server surat Anda dan saat ini hanya dipakai untuk email uji cobanya.
Midtrans
Midtrans menerima pembayaran online pelanggan Anda ke akun Midtrans milik Anda sendiri: kartu (3D Secure terbuka di dalam Bakasir), QRIS, virtual account (BCA, BNI, BRI, Mandiri, Permata, CIMB), GoPay, ShopeePay, Indomaret, dan Alfamart. Langganan Bakasir ditagih dengan kunci milik Bakasir, bukan kunci Anda.
Yang perlu disiapkan
- Alamat email dan nomor telepon untuk akun Midtrans.
- Untuk Produksi (uang sungguhan), Midtrans meninjau bisnis Anda. Menurut Midtrans, perorangan membutuhkan KTP pemilik (ditambah NPWP bila ingin pembayaran kartu). Badan usaha membutuhkan KTP direktur, NPWP perusahaan, akta pendirian dan perubahan, serta SK Kemenkumham. Anda juga perlu situs web, atau tautan media sosial atau katalog produk bila belum punya situs. Lihat daftar dokumen legal Midtrans.
- Waktu: sekitar 15 menit untuk Sandbox. Persetujuan Produksi ada di pihak Midtrans, dan pembayaran kartu bisa memakan waktu hingga 10 hari kerja.
Tautan yang Anda perlukan
- Daftar: dashboard.midtrans.com/register. Panduan pendaftaran Midtrans dalam bahasa Indonesia menunjukkan tiap langkahnya.
- Dasbor Sandbox (untuk uji coba): dashboard.sandbox.midtrans.com. Dasbor Produksi (uang sungguhan): dashboard.midtrans.com/login.
- Access Keys: Sandbox dan Produksi. Anda harus sudah masuk.
- Mengaktifkan metode pembayaran tambahan nanti: dashboard.midtrans.com/new_payment_method.
- Panduan Midtrans: akun dan kunci Midtrans, URL notifikasi, menguji pembayaran di Sandbox, pindah ke Produksi.
- Biaya: midtrans.com/pricing.
Buat akun Midtrans
Buka dashboard.midtrans.com/register, isi formulir, lalu konfirmasi email Anda (cari email berjudul "Instruksi Konfirmasi"). Lingkungan Sandbox dibuat otomatis dan gratis.
Ambil kunci Sandbox
Masuk ke dashboard.sandbox.midtrans.com. Tombol Environment di kiri atas menunjukkan Anda sedang berada di mana (Sandbox bersidebar oranye, Produksi bersidebar biru). Buka Settings → Access Keys lalu salin Client Key dan Server Key. Server Key itu rahasia: jangan dibagikan.
Isi di Bakasir
Di Pengaturan → Integrasi, klik Hubungkan pada Midtrans. Tempel Client Key dan Server Key. Mode mengikuti Server Key: kunci berawalan SB- berjalan di Sandbox, kunci lain di Produksi.
Pilih Acquirer QRIS (GoPay atau ShopeePay (airpay shopee)), yaitu jaringan QRIS yang aktif di akun Midtrans Anda. Jika ragu, biarkan GoPay.
Tempel URL notifikasi ke Midtrans
Jendela Midtrans di Bakasir menampilkan Payment Notification URL. Klik Salin. Di dasbor Midtrans (environment yang sama dengan kuncinya) buka Settings → Payment, cari Payment Notification URL, tempel, lalu simpan. Dasbor dan panduan Midtrans yang lebih lama menyebut halaman ini Settings → Configuration, dengan tombol Update. Di Bakasir cloud alamatnya:
https://api.bakasir.com/webhooks/shop/midtransBiarkan Recurring Notification URL dan Pay Account Notification URL (penautan akun) kosong. Finish Redirect URL tidak dipakai, karena 3D Secure kartu terbuka di dalam Bakasir. URL harus bisa dijangkau dari internet, jadi tidak boleh alamat lokal.
Uji dan simpan
Klik Uji Koneksi. Bakasir menyimpan isian Anda lalu meminta Midtrans memastikan Server Key. Saat muncul Berhasil. Kredensial Anda bekerja., klik Simpan. Kartu kini menampilkan Terhubung.
Buat pesanan uji
Buka toko online Anda, masukkan produk ke keranjang, dan pilih Pembayaran Online saat checkout. Bayar dengan simulator Midtrans, mengikuti menguji pembayaran di Sandbox: simulator QRIS untuk QRIS dan e-wallet, simulator bank untuk virtual account, dan nomor kartu uji di halaman itu untuk kartu. Di E-Commerce → Pesanan Online, pesanan akan berubah menjadi Lunas dengan sendirinya.
Jangan bayar pesanan Sandbox dengan uang sungguhan
Nomor virtual account dan kode QR Sandbox bisa sama dengan yang asli. Midtrans memperingatkan bahwa uang sungguhan yang dikirim ke sana bisa hilang. Pakai simulator saja.
Beralih ke produksi
- Selesaikan aktivasi. Di dasbor Produksi, lengkapi banner pendaftaran ("One more step!") dan unggah dokumen yang disebut di atas. Midtrans bisa mengirim email untuk meminta informasi tambahan.
- Geser tombol Environment ke Production, buka Settings → Access Keys, lalu salin kunci Produksi.
- Di Bakasir buka Midtrans → Kelola, tempel Client Key dan Server Key Produksi (kunci Produksi tidak berawalan
SB-), klik Uji Koneksi, lalu Simpan. - Di dasbor Produksi, isi lagi Payment Notification URL. Sandbox dan Produksi punya pengaturan sendiri-sendiri.
- Buat satu pesanan sungguhan dengan nilai kecil (Midtrans menyarankan minimal Rp10.000) dan pastikan pesanannya menjadi Lunas. Batalkan atau kembalikan dananya setelahnya bila perlu.
Untuk mengaktifkan metode lain (misalnya kartu atau Indomaret), pakai + Payment Method di dasbor Produksi.
Pakai URL toko, bukan yang lain
Pakai URL yang berakhiran /webhooks/shop/midtrans. URL /webhooks/midtrans hanya untuk penagihan langganan Bakasir sendiri dan tidak akan mengonfirmasi pesanan pelanggan Anda.
Yang dilihat pelanggan Anda. Saat checkout, toko menampilkan Pilih metode pembayaran dengan kelompok Kartu, QRIS, Virtual Account, E-wallet, dan Gerai retail, sesuai yang aktif di akun Midtrans Anda. Data kartu langsung dikirim ke Midtrans dan tidak pernah sampai ke Bakasir. Setelah membayar, halaman diperbarui sendiri dan pesanan berubah menjadi Lunas di Portal Anda.
Biaya. Midtrans menagih Anda per transaksi yang berhasil, dan pendaftaran gratis. Tarif yang terlihat pada 2 November 2026 di midtrans.com/pricing, sebelum PPN: virtual account Rp4.000, QRIS 0,7%, GoPay 2%, kartu kredit 2,9% ditambah Rp2.000. Cek halamannya untuk tarif terkini. Bakasir tidak menambah biaya apa pun.
Masalah umum
| Yang Anda lihat | Penyebab dan solusi |
|---|---|
| midtrans rejected the server key: check the key and that it matches the selected mode | Kunci dan environment tidak cocok. Kunci Sandbox (SB-) hanya bekerja di Sandbox, kunci Produksi hanya di Produksi. Salin ulang kunci tanpa spasi. |
| server_key is required | Anda mengklik Uji Koneksi saat Server Key masih kosong. Tempel dulu. |
| Pelanggan sudah membayar tetapi pesanan tetap belum lunas | Pastikan Payment Notification URL tersimpan di environment Midtrans yang benar, lalu cek pesanan lagi. Bakasir juga bertanya langsung ke Midtrans saat halaman pembayaran pelanggan memeriksa status, sehingga notifikasi yang terlambat tetap tertangani. |
| Pilihan Pembayaran Online tidak muncul di checkout | Anda masih di paket Gratis, toko tidak berjualan dalam IDR, atau kuncinya belum lengkap (kedua kunci wajib diisi). |
| Metode pembayaran yang diinginkan pelanggan tidak ada | Metode itu belum aktif di akun Midtrans Anda. Ajukan lewat + Payment Method di dasbor Produksi. |
| the QRIS acquirer is gopay or airpay shopee | Pilih salah satu dari dua nilai di daftar Acquirer QRIS. |
DOKU
DOKU menerima pembayaran online ke akun DOKU milik Anda sendiri: QRIS, virtual account (BCA, BNI, BRI, Mandiri, Permata, CIMB), DANA, ShopeePay, OVO, Indomaret, dan Alfamart. DOKU tidak menyediakan pembayaran kartu di Bakasir. DOKU memakai pasangan kunci: Anda memberi DOKU kunci publik Anda, dan DOKU memberi Anda kunci publiknya.
Yang perlu disiapkan
- Alamat email bisnis dan nomor telepon untuk akun DOKU.
- Untuk Produksi, DOKU memverifikasi bisnis Anda dalam sekitar 48 jam. Menurut DOKU, perusahaan membutuhkan NIB, akta pendirian dan perubahan, surat persetujuan Kemenkumham, NPWP, KTP direktur, dan foto bukti usaha (lokasi, kegiatan, atau produk). Usaha tanpa badan hukum (khusus WNI) membutuhkan KTP, selfie sambil memegang KTP, dan foto bukti usaha. Berkas harus terbaca jelas dan tidak disensor (PDF, JPG, atau PNG, maksimal 15 MB per berkas). Sebagian produk membutuhkan izin tambahan.
- Waktu: sekitar 20 menit untuk Sandbox. Sebagian metode pembayaran diaktifkan oleh tim sales DOKU, jadi sediakan waktu tambahan.
Tautan yang Anda perlukan
- Daftar untuk produksi: dashboard.doku.com/bo/register. Daftar untuk Sandbox (uji coba): sandbox.doku.com/bo/sandbox-registration.
- Masuk: Sandbox dan Produksi.
- Panduan DOKU: membuat akun, mengaktifkan bisnis (Indonesia), mengaktifkan layanan, API key dan kunci publik, URL notifikasi per metode pembayaran, simulasi transaksi.
- Biaya: doku.com/pricing.
Buat akun
Buat akun Sandbox lebih dulu dengan tautan Sandbox di atas, lalu akun Produksi saat Anda siap. Keduanya terpisah: login untuk yang satu tidak berlaku di yang lain. Untuk Produksi, masukkan OTP yang DOKU kirim ke email Anda, lalu ikuti panduan aktivasi DOKU: pilih jenis akun, isi data bisnis, unggah dokumen, dan tunggu email verifikasi.
Aktifkan layanan
Di dasbor DOKU buka Settings, lalu di bagian Account pilih Service, klik ADD SERVICE, pilih layanannya (virtual account, QRIS, e-wallet, convenience store), lalu klik ACTIVATE. Sebagian layanan perlu disetujui tim sales DOKU.
Pilih mode di Bakasir
Di Pengaturan → Integrasi, klik Hubungkan pada DOKU lalu pilih Sandbox untuk mencoba atau Produksi untuk pembayaran sungguhan. Harus sama dengan environment DOKU tempat Anda menyalin kunci.
Salin Client ID dan Secret Key
Di dasbor DOKU buka Settings, lalu di bagian Account pilih API Keys. Dasbor yang lebih lama menyebutnya Integration → API Keys. Client ID Anda ada di halaman itu. Klik Reveal Key, masukkan kode 6 digit yang DOKU kirim ke email Anda, lalu salin Secret Key dalam 30 detik. Tempel keduanya ke isian Client ID dan Secret Key di Bakasir.
Buat pasangan kunci
Di Bakasir klik Buat pasangan kunci. Bakasir membuat pasangannya dan menampilkan Kunci publik Anda. Klik Salin, lalu tempel di halaman API Keys yang sama di dasbor DOKU, sebagai Merchant Public Key Anda. Kunci privat tetap di server dan tidak pernah ditampilkan.
Salin kunci publik DOKU kembali
Di halaman API Keys DOKU klik Reveal Key di samping DOKU Public Key lalu salin. Tempel seluruh blok, termasuk baris BEGIN dan END, ke Kunci publik DOKU di Bakasir.
Tempel URL ke DOKU
Jendela Bakasir menampilkan dua URL. Di Bakasir cloud alamatnya:
| Isian di Bakasir | Tempatnya di dasbor DOKU | URL |
|---|---|---|
| URL notifikasi | Settings → Payment Settings, lalu tiap kanal yang Anda pakai: Virtual Account (klik Configure), QR Payment untuk QRIS (klik Edit), e-Wallet dan Convenience Store (klik CONFIGURE). Simpan masing-masing. | https://api.bakasir.com/webhooks/shop/doku |
| URL token SNAP (Virtual Account) | Settings → Account → API Keys, di isian Token URL. | https://api.bakasir.com/webhooks/shop/doku/token |
DOKU memanggil URL token untuk meminta token sebelum mengirim pemberitahuan pembayaran virtual account. Jika suatu kanal tidak punya URL, DOKU tidak mengirim pemberitahuannya dan pembayaran tidak terkonfirmasi.
Uji dan simpan
Klik Uji Koneksi. Saat muncul Berhasil. Kredensial Anda bekerja., klik Simpan. Kartu menampilkan Terhubung.
Buat pesanan uji lalu beralih ke produksi
Di Sandbox, buat pesanan uji dari toko Anda. Bayar dengan simulator DOKU: di dasbor Sandbox buka Settings → Payment Settings → Simulator, pilih metode pembayarannya, lalu klik Simulate. Pastikan pesanan berubah menjadi Lunas.
Untuk beralih ke produksi, ulangi langkah di atas dengan akun Produksi Anda: ubah mode ke Produksi, salin Client ID, Secret Key, dan kunci publik DOKU milik Produksi, daftarkan Kunci publik Anda dan kedua URL di dasbor Produksi, lalu klik Uji Koneksi dan Simpan. Buat satu pesanan sungguhan bernilai kecil untuk memastikan.
Mengganti pasangan kunci
Jika Anda mengklik Ganti pasangan kunci, kunci publik yang lama berhenti bekerja. Tempel kunci publik yang baru ke dasbor DOKU lagi, kalau tidak pembayaran tidak akan terkonfirmasi.
Nama menu DOKU
DOKU sesekali mengubah dasbornya, dan dasbor Sandbox dan Produksi bisa sedikit berbeda. Jika Anda tidak menemukan tempat untuk Merchant Public Key, Token URL, atau URL notifikasi, cari nama isiannya di dasbor, atau tanyakan ke DOKU Care. Bakasir membutuhkan empat hal ini terdaftar di DOKU: kunci publik Anda, URL notifikasi untuk tiap kanal yang dipakai, URL token, serta Client ID dan Secret Key Anda.
Yang dilihat pelanggan Anda. Saat checkout, toko menampilkan Pilih metode pembayaran dengan kelompok QRIS, Virtual Account, E-wallet (DANA, ShopeePay, OVO), dan Gerai retail (Indomaret, Alfamart). Untuk OVO, pelanggan mengetik nomor telepon yang terdaftar di aplikasi OVO lalu menyetujui pembayaran di sana. Halaman diperbarui sendiri setelah pembayaran diterima.
Biaya. DOKU menagih per transaksi, dan tarifnya bergantung pada metode. Tarif yang terlihat pada 2 November 2026 di doku.com/pricing, sebelum PPN: QRIS 0,7% di atas Rp100.000, virtual account Rp4.000 (BCA Rp4.500), DANA 1,5%. Halaman itu juga mencantumkan biaya proses QRIS yang berlaku mulai 1 November 2026. Cek halamannya untuk tarif terkini.
Masalah umum
| Yang Anda lihat | Penyebab dan solusi |
|---|---|
| doku rejected the Client ID or private key | Kunci publik belum terdaftar di dasbor DOKU, atau modenya tidak cocok. Daftarkan Kunci publik Anda di environment yang sama dengan yang Anda pilih. |
| doku rejected the Secret Key: check the key and that it matches the selected mode | Salin ulang Secret Key dari environment yang benar. Jika Anda membuat ulang di DOKU, salin yang baru. |
| doku public key is not a valid PEM | Tempel seluruh blok kunci dengan baris BEGIN dan END, tanpa teks tambahan. |
| client_id is required atau secret_key is required | Anda mengklik Uji Koneksi saat isiannya masih kosong. |
| Pembayaran virtual account tidak terkonfirmasi | Pastikan URL notifikasi (di kanal Virtual Account) dan URL token sama-sama sudah diisi di DOKU. |
| Pembayaran QRIS atau e-wallet tetap belum lunas | Cek URL notifikasi di kanal QR Payment atau e-Wallet, dan pastikan layanannya aktif di Settings → Account → Service. |
| Pilihan Pembayaran Online tidak muncul di checkout | Anda masih di paket Gratis, toko tidak berjualan dalam IDR, atau kartu DOKU belum lengkap. Client ID, Secret Key, kunci publik DOKU, dan pasangan kunci Anda semuanya wajib. |
Memilih gateway pembayaran aktif
Jika Midtrans dan DOKU sama-sama terhubung, Gateway pembayaran aktif muncul di bagian atas halaman. Pilih yang menerima pembayaran pelanggan Anda. Kartu gateway yang aktif menampilkan Gateway aktif. Jika hanya satu yang terhubung, itu yang otomatis dipakai. Pesanan yang sudah dimulai dengan satu gateway tetap diselesaikan dengan gateway itu.
Biteship
Biteship memberi toko online Anda tarif kurir langsung saat checkout dan membuat pengiriman serta resi dari pesanan. Ini bagian dari plugin Shipping, yang membutuhkan E-Commerce. Kartu Biteship membuka Pengaturan → Pengiriman.
Yang perlu disiapkan
- Akun Biteship, serta plugin E-Commerce Suite dan Shipping yang sudah terpasang.
- Alamat penjemputan beserta nama dan nomor telepon kontak, dan berat produk Anda dalam gram.
- Toko yang berjualan dalam IDR.
- Saldo di akun Biteship untuk pengiriman live. Pengiriman dibayar dari saldo Biteship Anda, bukan oleh Bakasir.
- Waktu: sekitar 20 menit dengan key uji coba. Untuk pemakaian live, Biteship harus mengaktifkan Order API Anda, yang punya peninjauan sendiri.
Tautan yang Anda perlukan
- Daftar: dashboard.biteship.com/signup. Masuk: dashboard.biteship.com/signin.
- API key dan webhook: dashboard.biteship.com/integrations.
- Panduan Biteship: membuat API key, Sandbox (mode testing), go live, mengirim permintaan aktivasi, ringkasan webhook.
- Paket dan batasan: biteship.com/en/docs/plans.
Pasang plugin
Pasang E-Commerce Suite dan Shipping dari Plugin → Marketplace. Lihat katalog plugin.
Buat API key uji coba
Di dasbor Biteship aktifkan tombol Testing Mode di sidebar, buka Integrations, klik Pengaturan, lalu Tambah Kunci API. Beri nama, lalu salin key-nya saat itu juga karena Biteship hanya menampilkannya sekali. Key uji coba berawalan biteship_test. dan key live berawalan biteship_live.. Order API aktif secara bawaan di Testing Mode.
Hubungkan di Bakasir
Di Pengaturan → Pengiriman, tempel API key, klik Simpan, lalu klik Tes koneksi. Anda akan melihat Biteship menerima key ini.
Tambahkan webhook
Di Bakasir salin URL webhook (klik Salin URL webhook). Di dasbor Biteship buka Integrations, klik Pengaturan pada kartu webhook lalu Tambah Webhook, tempel URL-nya, dan pilih event order.status dan order.waybill_id. Simpan. URL ini memuat kunci rahasia toko Anda, jadi jaga kerahasiaannya. Pakai webhook terpisah untuk key uji coba dan key live.
Atur penjemputan dan pengiriman
Isi Alamat penjemputan: cari dan pilih Area (kecamatan) (ketik minimal 3 huruf), lalu Nama kontak, Telepon kontak, dan Alamat lengkap. Di Opsi pengiriman pilih Kurir yang boleh dipakai pembeli, atur Berat bawaan per barang (gram) untuk produk yang belum punya berat, dan bila perlu Gratis ongkir mulai dari serta Asuransikan paket. Klik Simpan.
Beralih ke live
Setelah uji coba berhasil, minta Biteship mengaktifkan Order API live Anda. Di dasbor Biteship matikan Testing Mode dan buat API key live dengan cara yang sama seperti key uji coba (Order API-nya tetap nonaktif sampai Biteship menyetujui). Buka Integrations, klik Aktivasi Order API, pilih API key live dan kurirnya, isi Test Order ID dari pengiriman uji Anda, lengkapi formulir, lalu klik Kirim Data Aktivasi API. Tunggu sampai statusnya Aktif. Setelah itu tempel key live di Bakasir (Pengaturan → Pengiriman), simpan, tes lagi, dan tambahkan webhook untuk key live.
Terakhir aktifkan Tagih ongkir saat checkout. Syaratnya API key, alamat penjemputan, dan minimal satu kurir.
Buat pengiriman dari pesanan
Buka E-Commerce → Pesanan Online, buka sebuah pesanan, lalu klik Buat pengiriman. Membuat pengiriman memesan kurir dan memotong saldo Biteship Anda. Pesanan lalu menampilkan resi, riwayat pelacakan, serta tombol untuk memperbarui pelacakan, membuka halaman pelacakan, atau membatalkan pengiriman.
Yang dilihat pelanggan Anda. Saat checkout, toko meminta area tujuan dan menampilkan kurir yang Anda pilih beserta harganya. Pesanan di atas nilai Gratis ongkir mulai dari gratis ongkir (Anda tetap membayar kurir). Setelah Anda membuat pengiriman, pembeli bisa melacak paketnya.
Biaya. Biteship punya paket bulanan dengan kuota, dan permintaan live di luar kuota ditagih dari saldo Biteship Anda. Key uji coba tidak dihitung ke kuota. Lihat Paket dan batasan. Ongkos kurir dibayar dari saldo Biteship Anda dan dibebankan ke pembeli dalam harga ongkir.
Masalah umum
| Yang Anda lihat | Penyebab dan solusi |
|---|---|
| Tidak bisa terhubung ke Biteship dengan key ini. | Key salah, atau tersalin dengan spasi. Salin ulang. Pakai key uji coba selama Testing Mode aktif dan key live setelah aktivasi. |
| Simpan API key dulu, lalu tes koneksi. | Klik Simpan sebelum Tes koneksi. |
| Isi API key, alamat penjemputan dan minimal satu kurir sebelum mengaktifkan pengiriman. | Salah satu dari ketiganya belum ada. Lengkapi dan simpan, lalu aktifkan Tagih ongkir saat checkout. |
| Periksa isian: key, area, telepon dan kurir harus valid. | Pilih area dari daftar, jangan hanya mengetik, dan isi nomor telepon yang valid. |
| Pengiriman otomatis hanya untuk toko yang berjualan dalam IDR. | Mata uang toko bukan IDR. |
| Ongkir tidak muncul saat checkout | Kedua plugin harus aktif, dan Tagih ongkir saat checkout harus menyala. |
| Pelacakan tidak pernah berubah | Webhook belum dipasang atau memakai kunci yang salah. Tambahkan lagi URL webhook, atau klik Perbarui pelacakan pada pesanan. |
WhatsApp mengirim pesan dari nomor WhatsApp Business Anda sendiri lewat Cloud API Meta, dan Meta menagih biaya pesan ke akun Anda. Tanpa koneksi, Bakasir tetap membuka tautan chat WhatsApp untuk Anda kirim manual. Kartu WhatsApp membuka halamannya sendiri, Pengaturan → Integrasi → WhatsApp Business.
Yang perlu disiapkan
- Akun Facebook dan portofolio bisnis Meta (Business Manager).
- Nomor telepon WhatsApp Business yang bisa menerima kode verifikasi, dan metode pembayaran untuk penagihan Meta.
- Nama bisnis, alamat, dan situs web Anda, jika Meta meminta verifikasi bisnis untuk menaikkan batas Anda.
- Waktu: sekitar 30 menit, lalu Meta meninjau tiap template pesan (hingga 24 jam).
Tautan yang Anda perlukan
- Meta for Developers (aplikasi): developers.facebook.com/apps. Anda harus sudah masuk.
- Panduan penyiapan Meta: WhatsApp Cloud API, get started.
- Token permanen: Business management API, system users.
- App secret: Pengaturan dasar aplikasi.
- Template pesan: template di WhatsApp Manager dan panduan template Meta.
- Webhook: field webhook Meta.
- Harga: harga WhatsApp.
Buat aplikasi Meta
Di Meta for Developers klik Create App, isi nama dan email, lalu pilih use case Connect with customers through WhatsApp. Pilih atau buat portofolio bisnis Anda saat diminta. Setelah itu klik Start using the API untuk membuka API Setup.
Tambahkan nomor dan salin ID
Di API Setup, hubungkan akun WhatsApp Business, lalu tambahkan nomor telepon asli Anda dari daftar From dan verifikasi. Tambahkan metode pembayaran untuk pesan yang dimulai bisnis saat Meta memintanya. Salin Phone number ID nomor itu. ID akun WhatsApp Business (WABA ID) bersifat opsional dan juga tampil di WhatsApp Manager.
Buat token permanen
Token sementara di API Setup akan kedaluwarsa, jadi jangan dipakai. Di Business Settings Meta buka System users (di bawah Users) lalu klik Add untuk membuat system user. Klik Assign assets dan beri Manage app pada aplikasi Anda dan Manage WhatsApp Business accounts pada akun WhatsApp Anda. Klik Generate token lalu centang business_management, whatsapp_business_messaging, dan whatsapp_business_management. Salin token sekarang: inilah Token akses (Access token), dan Meta tidak menampilkannya lagi.
Salin app secret
Di aplikasi Meta Anda buka App settings → Basic lalu klik Show di samping App secret. Bakasir hanya memakainya untuk memverifikasi webhook status kirim.
Hubungkan di Bakasir
Di Pengaturan → Integrasi klik Hubungkan pada WhatsApp. Di halaman WhatsApp Business, tempel ID nomor telepon (Phone number ID), ID akun WhatsApp Business (WABA ID) (opsional), Token akses (Access token), dan Rahasia aplikasi (App secret), lalu klik Simpan dan Tes koneksi. Koneksi yang berhasil menampilkan nama nomor dan peringkat kualitasnya. Lencana status berubah dari Tersimpan, belum diverifikasi menjadi Terhubung.
Buat template pesan
Meta harus menyetujui tiap template sebelum bisa dipakai, biasanya dalam 24 jam. Di WhatsApp Manager buat template baru, pilih kategori Utility, dan buat satu template per jenis pesan dengan jumlah variabel dan urutan yang persis seperti di bawah. Kalimatnya boleh diubah. Contoh teks:
| Pesan | Nama template yang disarankan | Variabel, berurutan | Contoh teks |
|---|---|---|---|
| Struk penjualan | bakasir_receipt | 1 nama pelanggan, 2 nomor struk, 3 total, 4 nama bisnis, 5 tautan struk | Halo {{1}}, terima kasih telah berbelanja di {{4}}. Struk {{2}} senilai {{3}} sudah siap: {{5}} |
| Pesanan pembelian | bakasir_purchase_order | 1 nama pemasok, 2 nomor pesanan pembelian, 3 total, 4 nama bisnis. Tambahkan header Document (PDF): Bakasir melampirkan PDF-nya. | Halo {{1}}, terlampir pesanan pembelian {{2}} dengan total {{3}} dari {{4}}. |
| Status pesanan online | bakasir_order_status | 1 nama pembeli, 2 nomor pesanan, 3 status, 4 nama bisnis | Halo {{1}}, pesanan {{2}} Anda di {{4}} sekarang {{3}}. |
| Pengingat reservasi | bakasir_reservation_reminder | 1 nama tamu, 2 tanggal dan jam, 3 nama bisnis | Halo {{1}}, kami mengingatkan reservasi Anda di {{3}} pada {{2}}. |
Variabel tidak boleh berisi baris baru. Bakasir menggantinya dengan spasi.
Beri tahu Bakasir template mana yang dipakai
Di bagian Pesan yang dikirim pada halaman Bakasir, aktifkan tiap jenis pesan yang Anda inginkan, isi Nama template persis seperti di Meta, dan pilih Bahasa template (id, en, atau en_US) yang Anda pakai di Meta. Klik Simpan. Jenis pesan yang mati, atau tanpa nama template, kembali memakai tautan chat WhatsApp.
Kirim tes
Di Kirim tes isi nomor telepon Anda sendiri, pilih Jenis pesan, lalu klik Kirim. Ini mengirim satu pesan sungguhan memakai template yang tersimpan, jadi Meta dapat menagih akun Anda. Buka Log pesan (100 pesan terakhir) dan klik Muat ulang untuk melihat statusnya.
Opsional: webhook status pengiriman
Agar Terkirim, Diterima, Dibaca, dan Gagal tampil di log, simpan dulu app secret di Bakasir. Lalu di aplikasi Meta Anda buka WhatsApp → Configuration (aplikasi baru: Use cases → Customize → Configuration). Tempel Callback URL dan Token verifikasi (Verify token) yang tampil di Bakasir, klik Verify and save, lalu berlangganan ke field messages. Sebagian webhook tidak dikirim saat aplikasi Meta masih dalam mode Development, jadi ubah aplikasi ke Live bila status tidak pernah masuk.
Yang dilihat pelanggan dan pemasok Anda. Pesan WhatsApp dari nomor bisnis Anda dengan teks template yang sudah disetujui. Resi via WhatsApp pada penjualan atau pesanan online mengirimnya langsung, tidak lagi membuka chat. Pembeli online juga mendapat pesan saat pesanannya masuk dan setiap kali statusnya berubah. Pesanan pembelian dikirim ke pemasok dengan PDF terlampir.
Biaya. Meta menagih per pesan yang terkirim, berdasarkan kategori template dan negara penerima. Template Utility dikenai biaya, dan tiap nomor bisnis mendapat jatah bulanan pesan layanan gratis. Tarif dan aturannya berubah, jadi baca harga WhatsApp. Bakasir tidak menambah biaya.
Masalah umum
| Yang Anda lihat | Penyebab dan solusi |
|---|---|
| phone_number_id and access_token are required | Simpan Phone number ID dan Access token sebelum Tes koneksi. |
| Access token WhatsApp tidak valid atau kedaluwarsa | Anda memakai token sementara, atau system user kehilangan akses. Buat token permanen lagi lalu tempel. |
| Template WhatsApp tidak ada, belum disetujui, atau jumlah variabelnya berbeda | Nama atau bahasa template tidak sama dengan di Meta, Meta belum menyetujuinya, atau variabelnya berbeda dari tabel di atas. |
| Nomor itu tidak memakai WhatsApp atau tidak dapat menerima pesan ini | Pastikan nomor memakai kode negara. Orangnya mungkin tidak memakai WhatsApp. |
| WhatsApp hanya mengizinkan template yang disetujui di luar jendela chat 24 jam | Jenis pesan itu belum punya template, atau belum diaktifkan. Isi dan aktifkan di Pesan yang dikirim. |
| WhatsApp membatasi pesan Anda, coba lagi nanti | Meta membatasi laju nomor Anda. Tunggu lalu coba lagi, dan hindari mengirim banyak pesan sekaligus. |
| Akun Meta Anda bermasalah dengan pembayaran, perbaiki di Meta Business Suite | Tambahkan atau perbaiki metode pembayaran di Meta Business Suite. |
| WhatsApp belum terhubung atau jenis pesan ini belum diaktifkan | Hubungkan WhatsApp, dan nyalakan jenis pesannya. |
| Isi nama template yang disetujui sebelum mengaktifkan ini | Jenis pesan tidak bisa menyala tanpa nama template. |
| WhatsApp Cloud API tidak terjangkau, coba lagi nanti | Gangguan sementara di sisi Meta. Coba lagi nanti. |
| Status pengiriman tidak pernah berubah dari Terkirim | Webhook belum dipasang. Lakukan langkah webhook opsional dan berlangganan ke messages. |
SMTP
SMTP menyimpan login server surat Anda sendiri. Saat ini hanya Kirim Uji Coba yang memakainya: mengirim satu email sungguhan ke email akun Anda. Bakasir belum mengirim struk atau notifikasi lewat server ini, jadi menghubungkannya belum mengubah hal lain. Anda boleh menghubungkannya sekarang supaya sudah siap.
Yang perlu disiapkan
- Akun di penyedia email, atau detail SMTP server Anda sendiri.
- Alamat atau domain pengirim yang sudah Anda verifikasi di penyedia itu. Penyedia menolak surat dari pengirim yang belum diverifikasi.
- Waktu: sekitar 10 menit.
Panduan per penyedia. Bakasir mengisi host, port, dan enkripsi saat Anda memilih penyedia.
| Penyedia | Host dan port | Nama pengguna | Kata sandi | Tautan |
|---|---|---|---|---|
| Brevo | smtp-relay.brevo.com, 587, STARTTLS | SMTP login yang tampil di tab SMTP | SMTP key (bukan API key) | Daftar, SMTP & API, panduan SMTP Brevo, harga |
| SendGrid | smtp.sendgrid.net, 587, STARTTLS | apikey | API key SendGrid dengan izin Mail Send | Daftar, API keys, panduan SMTP, verifikasi pengirim, harga |
| Gmail | smtp.gmail.com, 587, STARTTLS | Alamat Gmail lengkap Anda | Sandi aplikasi (app password) Google | Aktifkan Verifikasi 2 Langkah, buat sandi aplikasi, halaman sandi aplikasi, batas pengiriman Gmail SMTP |
| Mailtrap | live.smtp.mailtrap.io, 587, STARTTLS | api | API token dari domain pengirim Anda | Daftar, integrasi SMTP, verifikasi domain pengirim, harga |
| Postmark | smtp.postmarkapp.com, 587, STARTTLS | Server API Token | Server API Token yang sama | Daftar, panduan SMTP, sender signature, harga |
| Server kustom | Host Anda, dan port 25, 465, 587, atau 2525 | Dari penyedia Anda | Dari penyedia Anda | Tanyakan ke penyedia hosting Anda |
Buat kredensial SMTP
Ikuti baris penyedia Anda di tabel. Ringkasnya: Brevo, buka SMTP & API → SMTP lalu buat SMTP key. SendGrid, buka Settings → API Keys lalu buat key dengan izin Mail Send. Gmail, aktifkan Verifikasi 2 Langkah lalu buat sandi aplikasi (Google dapat menyembunyikan opsi ini di akun kantor atau sekolah). Mailtrap, buka Sending Setup (API/SMTP), pilih domain terverifikasi dan stream Transactional, geser ke SMTP, lalu salin API token-nya. Postmark, salin Server API Token dari Settings message stream server, dan pastikan akses SMTP aktif di server itu.
Verifikasi pengirim
Tambahkan dan verifikasi alamat atau domain yang akan Anda pakai untuk mengirim: SendGrid Settings → Sender Authentication, Mailtrap Domains → Add Domain (tambahkan rekaman DNS yang ditampilkan), Postmark sender signature atau domain, Brevo sender di akun Anda. Tanpa ini, uji coba gagal di penyedia.
Pilih penyedia di Bakasir
Di Pengaturan → Integrasi klik Hubungkan pada SMTP / Email, lalu pilih penyedia Anda di Penyedia SMTP (Brevo, SendGrid, Gmail, Mailtrap, Postmark, atau Server kustom). Host SMTP, Port, dan Enkripsi terisi otomatis. Sesuaikan port: STARTTLS (587) atau SSL/TLS (465).
Isi login dan pengirim
Isi Nama Pengguna dan Kata Sandi, lalu Nama Pengirim dan Email Pengirim. Pengirim harus alamat atau domain yang sudah Anda verifikasi di penyedia.
Kirim uji coba
Klik Kirim Uji Coba. Bakasir menyimpan isian lalu mengirim satu email sungguhan ke email akun Anda. Cek kotak masuk (dan spam), lalu klik Simpan. Kartu menampilkan Terhubung.
Biaya. Beberapa penyedia punya paket gratis, misalnya Mailtrap (4.000 email per bulan, 150 per hari) dan Postmark (100 per bulan) saat halaman ini ditulis. Lihat halaman harga tiap penyedia di tabel.
Masalah umum
| Yang Anda lihat | Penyebab dan solusi |
|---|---|
| port 123 is not an SMTP port: use 25, 465, 587 or 2525 | Pakai salah satu port ini. Pakai 587 dengan STARTTLS, atau 465 dengan SSL/TLS. |
| cannot resolve smtp host atau resolves to a non-public address | Nama host salah, atau mengarah ke alamat privat, yang tidak diizinkan di Bakasir cloud. |
| your account has no email address to send the test to | Isi email di profil Anda dulu. |
| host is required atau from_email is required | Isi Host SMTP dan Email Pengirim. |
| Uji coba gagal di penyedia (pesan dari server penyedia) | Nama pengguna, kata sandi, atau pengirim tidak diterima. Verifikasi pengirim di dasbor penyedia, dan pastikan Anda memakai SMTP key (Brevo) atau sandi aplikasi (Gmail), bukan kata sandi biasa. |
| Gmail menolak login | Verifikasi 2 Langkah harus aktif dan Anda harus memakai sandi aplikasi. |
Twilio
Twilio menyimpan dan memeriksa API key Twilio Anda. Bakasir belum mengirim SMS, jadi belum ada fitur yang memakainya. Anda boleh menghubungkannya sekarang supaya sudah siap.
Yang perlu disiapkan
- Akun Twilio. Waktu: sekitar 10 menit.
Tautan yang Anda perlukan
- Daftar: twilio.com/try-twilio. Console: console.twilio.com.
- Panduan Twilio: ringkasan API key dan membuat API key di Console.
- Harga: harga SMS untuk Indonesia.
Buat API key
Di Twilio Console buka Settings → Account settings → API keys & auth tokens (Console lama: Account → API keys & tokens) lalu klik Create API key. Beri nama dan pilih tipe Standard.
Salin nilainya
Salin SID (diawali SK, bukan Account SID) ke API Key, dan Secret ke API Secret. Twilio hanya menampilkan secret satu kali: salin sebelum menutup jendelanya.
Uji dan simpan
Klik Uji Koneksi, lalu Simpan.
Masalah umum
| Yang Anda lihat | Penyebab dan solusi |
|---|---|
| api_key is required atau api_secret is required | Isi kedua isian sebelum Uji Koneksi. |
| Pesan berawalan 401 | SID atau secret salah. Pakai SID key yang berawalan SK (bukan Account SID), dan salin ulang secret-nya. Jika hilang, buat key baru. |
Google Analytics
Google Analytics mengukur kunjungan ke toko online Anda. Bakasir memasang Measurement ID Anda di setiap halaman etalase publik. Portal dan POS tidak ikut diukur. Untuk pengunjung langsung di dalam Bakasir, lihat plugin Web Analytics di katalog plugin.
Yang perlu disiapkan
- Akun Google. Waktu: sekitar 5 menit. Google Analytics gratis untuk pemakaian umum.
Tautan yang Anda perlukan
- Buka Google Analytics: analytics.google.com.
- Panduan Google: menyiapkan Analytics untuk situs web, menemukan Measurement ID, laporan Realtime.
Buat properti dan web stream
Di Google Analytics klik Admin, lalu Create → Property dan ikuti arahannya. Di bawah Data collection and modification klik Data streams, lalu Add stream → Web. Isi alamat toko Anda (misalnya toko-saya.bakasir.com) dan sebuah nama, lalu klik Create stream. Anda perlu peran Editor atau lebih tinggi pada properti.
Temukan Measurement ID
Buka Admin → Data collection and modification → Data streams, klik web stream Anda, lalu salin Measurement ID di detail stream. Bentuknya G-XXXXXXXXXX.
Simpan di Bakasir
Klik Hubungkan pada Google Analytics, tempel ID, lalu klik Simpan. Buka toko Anda, lalu lihat laporan Realtime di Google Analytics: kunjungan Anda akan muncul dalam satu atau dua menit.
Masalah umum: "measurement id must look like G-XXXXXXXXXX". Hanya ID Google Analytics 4 berawalan G- yang diterima. ID berawalan UA- (Universal Analytics lama) atau AW- (Google Ads) tidak bisa dipakai.
Tips
- Uji di Sandbox dulu. Buat pesanan uji dari toko Anda dan bayar dengan simulator penyedia sebelum memakai kunci Produksi.
- Satu gateway dalam satu waktu. Pelanggan membayar lewat gateway aktif saja.
- Produksi punya penyiapan sendiri. Kunci, URL notifikasi, dan webhook terpisah antara Sandbox dan Produksi. Ulangi setiap langkah di Produksi.
- Jaga kerahasiaan kunci. Jangan bagikan server key atau token kepada siapa pun, termasuk dukungan Bakasir.
- Mengganti kunci. Jika kunci bocor, buat yang baru di penyedia, tempel di Bakasir, lalu hapus yang lama di penyedia.