Pertanyaan yang sering ditanyakan
Jawaban singkat soal QRIS dinamis, payment link, Gateway Otomatis, biaya, saldo, KYC, dan API TemanQRIS. Semua angka di halaman ini mengikuti pengaturan yang berlaku saat ini.
Umum
Apa itu TemanQRIS, siapa di baliknya, dan ke mana uangmu mengalir.
Apa itu TemanQRIS?
TemanQRIS adalah platform untuk mengubah QRIS statis milikmu jadi QRIS dinamis, payment link, dan API pembayaran, ditambah mode Gateway Otomatis.
Mode manual memakai QRIS milikmu sendiri. Gateway Otomatis menerbitkan QRIS dengan kode unik lalu mencocokkan pembayarannya sendiri.
TemanQRIS cocok untuk siapa?
TemanQRIS cocok untuk pelaku usaha dan developer yang ingin menerima pembayaran QRIS dengan nominal otomatis, lewat dashboard, payment link, widget, atau API.
Contoh pemakaiannya ada di dokumentasi: checkout toko online, invoice lewat WhatsApp, kasir UMKM, tagihan SaaS, dan usaha dengan banyak outlet.
Siapa perusahaan di balik TemanQRIS?
TemanQRIS dinaungi PT INOVASI KSATRIA INDONESIA, badan usaha yang terdaftar lewat OSS dengan NIB 2606260070763.
Status NIB tercatat aktif dengan skala usaha kecil. Datanya bisa kamu cek di halaman Legalitas.
Apa KBLI TemanQRIS?
KBLI yang terdaftar adalah 58200 (Penerbitan Piranti Lunak) dan 58290 (Penerbitan Perangkat Lunak Lainnya).
Apakah TemanQRIS terdaftar sebagai PSE Komdigi?
Ya, TemanQRIS terdaftar sebagai Penyelenggara Sistem Elektronik di Komdigi dengan Tanda Daftar PSE 024115.02/DJAI.PSE/08/2026.
Nomor PSE bisa dicek di pse.komdigi.go.id dan NIB di oss.go.id.
Apakah TemanQRIS bank atau PJP?
Bukan. Menurut Syarat & Ketentuan, TemanQRIS adalah platform teknologi yang bekerja dengan penyedia pembayaran, bukan bank, PJP, atau penerbit uang elektronik.
Di mode manual, apakah uang pelanggan lewat TemanQRIS?
Tidak. Di mode manual, QR yang dibayar pelanggan adalah QRIS milikmu yang diberi nominal, jadi uang langsung masuk ke rekening atau e-wallet tempat QRIS itu terdaftar.
TemanQRIS hanya membuat QR dinamis dan mencatat status order.
Di mode Gateway Otomatis, uangnya masuk ke mana?
Pembayaran gateway masuk ke akun merchant GoPay milik platform, lalu dicatat sebagai saldo di wallet TemanQRIS-mu.
Saldo itu kamu tarik ke rekening bank atau e-wallet lewat menu Withdraw.
Apakah saldo di TemanQRIS sama dengan rekening bank?
Tidak. Saldo adalah catatan dana settlement di dashboard, bukan rekening bank, simpanan, atau uang elektronik, dan hanya bisa dicairkan lewat alur penarikan.
Apa bedanya mode manual dan Gateway Otomatis?
Mode manual memakai QRIS milikmu, uang langsung ke rekeningmu, dan pembayaran dikonfirmasi oleh merchant.
Gateway Otomatis memakai QRIS platform dengan kode unik, pembayaran dicocokkan otomatis, uang masuk ke saldo yang bisa ditarik mulai H+1, dan butuh KYC. Perbandingan lengkapnya ada di Harga dan paket.
Aplikasi apa yang bisa dipakai pelanggan untuk membayar?
Pelanggan cukup scan QR dengan aplikasi e-wallet atau m-banking apa pun yang mendukung QRIS. Nominalnya sudah terisi otomatis saat di-scan.
Apakah ada dokumentasi API?
Ada. Dokumentasi lengkap ada di /docs, spesifikasi OpenAPI di /openapi.json, dan ringkasan untuk AI di /llms.txt serta /llms-full.txt.
Biaya
Semua biaya yang bisa kamu temui, dari paket sampai penarikan saldo.
Berapa biaya memakai TemanQRIS?
Paket Free gratis dan Premium Rp9.000 per bulan untuk fitur QRIS manual.
Gateway Otomatis dikenai biaya layanan per transaksi yang sama untuk semua paket, dan penarikan saldo dikenai biaya penarikan.
Apakah TemanQRIS memotong MDR di mode manual?
Tidak. Di mode manual QR yang dibayar adalah QRIS milikmu, jadi TemanQRIS tidak menambah potongan per transaksi; biaya dari TemanQRIS hanya paket langganan.
Siapa yang menanggung MDR QRIS?
MDR dipotong oleh bank atau penyedia QRIS tempat kamu mendaftar dan menjadi tanggungan merchant sesuai ketentuan Bank Indonesia. Besarnya mengikuti aturan BI dan kategori usahamu, bukan TemanQRIS. Rinciannya ada di artikel MDR QRIS untuk UMKM.
Berapa biaya layanan Gateway Otomatis?
Biayanya 0,8% dari nominal dasar untuk semua nominal, dibulatkan ke atas ke rupiah penuh.
Tarif yang berlaku juga bisa dibaca lewat GET /api/payment-gateway/status.
| Nominal invoice | Biaya layanan | Masuk ke saldo |
|---|---|---|
| Rp10.000 | Rp80 | Rp9.920 |
| Rp50.000 | Rp400 | Rp49.600 |
| Rp100.000 | Rp800 | Rp99.200 |
| Rp150.000 | Rp1.200 | Rp148.800 |
| Rp1.000.000 | Rp8.000 | Rp992.000 |
Siapa yang menanggung biaya layanan gateway?
Merchant. Biaya layanan dipotong dari dana yang dikreditkan ke saldomu dan tidak ditambahkan ke total yang dibayar pelanggan.
Berapa yang masuk ke saldo dari satu pembayaran gateway?
Yang masuk adalah net_amount, yaitu nominal dasar ditambah biaya tambahan lalu dikurangi biaya layanan. Kode unik tidak ikut masuk ke saldo.
Bagaimana kalau nominalnya terlalu kecil untuk biaya layanan?
Invoice ditolak dengan amount_below_provider_fee kalau biaya layanan akan menghabiskan seluruh nominal dasar ditambah biaya tambahan.
Apa itu kode unik dan siapa yang membayarnya?
Kode unik adalah angka 0 sampai 999 rupiah yang ditambahkan ke total invoice gateway supaya setiap invoice punya total berbeda.
Pelanggan membayarnya sebagai bagian dari total. Kode ini dipilih server, menjadi pendapatan TemanQRIS, dan tidak dikembalikan.
Bisakah merchant menambahkan biaya tambahan ke tagihan?
Bisa. Di mode manual pakai fee_type rupiah atau persen, dan di gateway pakai fee_amount yang tidak boleh melebihi nominal dasar. Biaya tambahan itu ikut dibayar pelanggan.
Berapa biaya penarikan saldo?
Biaya penarikan 1% dari nominal yang ditarik dibulatkan ke atas, minimal Rp3.000 dan maksimal Rp4.500.
Biaya dipotong dari nominal yang kamu ajukan, jadi yang diterima di rekening adalah nominal dikurangi biaya.
| Nominal ditarik | Biaya | Diterima |
|---|---|---|
| Rp100.000 | Rp3.000 | Rp97.000 |
| Rp1.000.000 | Rp4.500 | Rp995.500 |
| Rp5.000.000 | Rp4.500 | Rp4.995.500 |
Apakah ada minimal penarikan?
Tidak ada angka minimal terpisah, tapi nominal penarikan harus lebih besar dari biayanya. Dengan biaya minimal Rp3.000, penarikan Rp3.000 atau kurang akan ditolak.
Apakah biaya penarikan dikembalikan kalau penarikan ditolak?
Ya. Kalau admin menolak penarikan, seluruh nominal yang diajukan termasuk biayanya kembali ke saldo tersedia.
Apakah Sandbox berbayar?
Tidak. Sandbox tidak memindahkan uang sungguhan dan tidak dikenai biaya apa pun.
Apakah KYC, API, webhook, widget, atau payment link berbayar?
Tidak ada biaya terpisah untuk semua itu. API, payment link, dan widget mode manual hanya memakai kuota request harian paketmu.
Apakah ada biaya kalau invoice gateway kedaluwarsa atau dibatalkan?
Tidak. Biaya layanan hanya diambil dari invoice gateway yang lunas, dengan tarif yang dicatat saat invoice dibuat.
Apakah ada biaya refund?
Tidak ada biaya refund, tapi refund tidak tersedia lewat API dan kode unik serta biaya layanan tidak dikembalikan.
Kalau refund terjadi di sisi penyedia, admin bisa menarik kembali dana yang sudah dikreditkan dari saldomu, paling banyak sebesar dana yang dikreditkan.
Harga dan paket
Free, Premium, dan kapan sebaiknya memakai Gateway Otomatis.
Berapa harga paket TemanQRIS?
Paket Free gratis, dan Premium Rp9.000 per bulan. Harga yang berlaku selalu tampil di halaman harga dan halaman Upgrade.
Apakah paket langganan memengaruhi biaya gateway?
Tidak. Gateway dikenai biaya per transaksi yang sama untuk semua paket dan tidak memakai kuota harian, sedangkan paket bulanan mengatur kuota fitur QRIS manual.
Mode manual atau Gateway Otomatis, mana yang cocok untukku?
Pilih mode manual kalau ingin uang langsung ke rekening QRIS sendiri tanpa KYC dan tanpa potongan dari TemanQRIS, dengan cek pembayaran sendiri.
Pilih Gateway Otomatis kalau butuh konfirmasi otomatis dan webhook tanpa cek manual, dengan biaya layanan per transaksi, KYC, dan dana yang bisa ditarik mulai H+1.
| Mode manual | Gateway Otomatis | |
|---|---|---|
| Uang masuk ke | Rekening atau e-wallet QRIS-mu | Saldo wallet TemanQRIS |
| Konfirmasi bayar | Oleh merchant | Otomatis oleh TemanQRIS |
| Potongan TemanQRIS | Tidak ada | 0,8% atau 0,8% per transaksi |
| Dana bisa dipakai | Sesuai bank atau e-wallet | Mulai 00.00 WIB H+1 |
| KYC | Tidak perlu | Wajib |
| Nominal maksimal | Rp100.000.000 | Rp1.000.000 |
Kalau perpanjang lebih awal, apakah sisa hari hilang?
Tidak. Masa aktif baru ditambahkan satu bulan dari tanggal berakhir yang sekarang, jadi sisa hari tetap utuh.
Apa yang terjadi pada QRIS dan link setelah turun ke Free?
Data tidak dihapus, dan payment link yang sudah dibuat tetap memakai masa berlaku saat dibuat.
Link dan riwayat baru mengikuti batas Free, dan upload QRIS baru di Free akan menggantikan QRIS default.
Apakah satu akun bisa dipakai untuk beberapa outlet?
Bisa di Premium: upload QRIS statis tiap outlet, lalu pilih QRIS-nya saat membuat QR atau payment link. Contohnya ada di use case banyak outlet.
QRIS dinamis dan generator
Upload QRIS statis, buat QRIS dinamis, dan atur biaya tambahan.
Apa beda QRIS statis dan QRIS dinamis?
QRIS statis tidak punya nominal sehingga pelanggan mengetik sendiri, sedangkan QRIS dinamis sudah berisi nominal sehingga tidak ada salah ketik. Penjelasan lengkapnya ada di QRIS statis vs dinamis.
Bisakah saya upload QRIS yang sudah dinamis?
Tidak bisa. Upload hanya menerima QRIS statis, dan QRIS dinamis akan ditolak.
Bagaimana cara memasukkan QRIS saya?
Upload foto QR atau tempel string QRIS-nya di halaman Generator. Sistem membaca gambar dengan beberapa cara dan memvalidasi format QRIS sebelum disimpan.
Format gambar QRIS apa yang didukung?
Gambar JPEG, PNG, GIF, BMP, atau TIFF dengan ukuran maksimal 1,5 MB.
Kenapa muncul "Could not decode QR code"?
Artinya sistem tidak berhasil membaca QR dari gambar yang diunggah. Coba foto yang lebih jelas, atau tempel string QRIS-nya secara manual.
Berapa QRIS merchant yang bisa saya simpan?
Paket Free menyimpan 1 QRIS, dan Premium 100 QRIS.
Apa yang terjadi kalau akun Free upload QRIS baru?
QRIS baru menggantikan QRIS default, bukan ditolak. Di Premium, kalau batas tercapai, upload ditolak dan kamu perlu menghapus QRIS lama dulu.
Berapa nominal yang bisa dibuat di QRIS dinamis?
Nominal QRIS dinamis mode manual harus bilangan bulat dari Rp1 sampai Rp100.000.000.
Bisakah saya menambahkan biaya ke QRIS dinamis?
Bisa, dengan fee_type rupiah atau persen. Biaya rupiah maksimal 10 kali nominal, dan biaya persen maksimal 100% dengan paling banyak 4 angka desimal.
Berapa lama QRIS dinamis dan payment link berlaku?
Payment link berlaku 24 jam di Free dan 7 hari di Premium. Riwayat QR disimpan 1 hari di Free dan 30 hari di Premium.
Bisakah saya memakai order_id sendiri?
Bisa, maksimal 30 karakter. Kalau order_id yang sama dikirim lagi saat order belum dibayar, link yang sama diperbarui; setelah dibayar atau dikonfirmasi pelanggan, nominalnya terkunci.
Bisakah order_id gateway dipakai lagi di mode manual?
Tidak. Order_id yang sudah dipakai invoice gateway ditolak di mode manual, supaya pembayaran gateway yang telat tidak menandai order yang salah.
Bisakah link pembayaran dibagikan lewat WhatsApp?
Bisa. Halaman Generator punya tombol bagikan ke WhatsApp dan Telegram yang berisi nominal dan link bayar.
Apakah ada panduan langkah demi langkah?
Ada. Panduan dari upload QRIS sampai webhook ada di Tutorial.
Payment link dan widget
Link bayar, konfirmasi pelanggan, dan tombol bayar di website.
Bagaimana alur payment link mode manual?
Kamu membuat link, pelanggan membuka halaman bayar, scan QR, lalu menekan "Saya sudah bayar".
Status order berubah jadi menunggu konfirmasi, kamu menerima notifikasi dan webhook, lalu kamu memverifikasi pembayaran di dashboard atau lewat API.
Apakah tombol "Saya sudah bayar" berarti uang sudah pasti masuk?
Tidak. Tombol itu hanya konfirmasi dari pelanggan; merchant tetap harus mengecek uangnya masuk sebelum menandai lunas.
Berapa lama payment link berlaku?
Payment link berlaku 24 jam di Free dan 7 hari di Premium. Link dari widget mode manual berlaku 60 menit, dan invoice gateway 1 jam.
Bisakah pelanggan konfirmasi setelah link kedaluwarsa?
Tidak. Konfirmasi hanya diterima selama link masih aktif; setelah itu pelanggan perlu minta link baru ke merchant.
Bagaimana cara membatalkan atau mengarsipkan payment link?
Order yang belum lunas bisa dibatalkan atau diarsipkan dari dashboard atau API, dan pelanggan akan melihat status dibatalkan di halaman bayar.
Order yang sudah lunas atau sudah dikonfirmasi pelanggan tidak bisa dibatalkan.
Apakah pelanggan otomatis diarahkan ke callback URL?
Tidak di halaman bayar. Halaman bayar hanya menampilkan tombol "Kembali ke Merchant" yang harus diklik pelanggan sendiri.
Apakah redirect dari widget bisa jadi bukti pembayaran?
Tidak. Widget mengarahkan pelanggan ke callback URL dengan status=confirmed setelah pelanggan menekan konfirmasi, tapi itu bukan bukti uang masuk. Pakai webhook yang terverifikasi atau cek status order dari server.
Bagaimana cara memasang widget di website?
Tambahkan satu tag script widget.js dengan atribut data-merchant berisi Merchant ID dari menu Widget di dashboard. Opsi lainnya ada di dokumentasi widget.
Apakah widget butuh API key?
Tidak. Widget memakai Merchant ID publik, bukan API key, jadi aman dipasang di halaman website.
Apakah halaman bayar diperbarui otomatis?
Ya. Halaman bayar mengecek status secara berkala, jadi status lunas atau dibatalkan muncul tanpa pelanggan perlu reload.
Bisakah pelanggan menyimpan gambar QR?
Bisa. Ada tombol untuk menyimpan gambar QR di halaman bayar.
Gateway Otomatis
Invoice GoPay dengan pencocokan pembayaran otomatis dan webhook.
Apa syarat memakai Gateway Otomatis?
Akunmu harus lolos verifikasi KYC. Tanpa KYC yang disetujui, pembuatan invoice gateway ditolak.
Provider apa yang dipakai Gateway Otomatis?
Saat ini Gateway Otomatis memakai GoPay. Pelanggan tetap bisa membayar dari aplikasi apa pun yang mendukung QRIS.
Bagaimana pembayaran gateway diverifikasi?
TemanQRIS mengecek mutasi GoPay secara berkala dan mencocokkan pembayaran dengan total invoice yang persis sama.
Begitu cocok, invoice ditandai lunas, saldo dikreditkan, dan webhook payment.confirmed dikirim.
Apakah pelanggan perlu menekan "Saya sudah bayar" di invoice gateway?
Tidak. Di invoice gateway tombol itu disembunyikan, dan halaman bayar menulis pembayaran diverifikasi otomatis oleh TemanQRIS.
Berapa lama QR gateway berlaku?
QR gateway berlaku 1 jam sejak diterbitkan.
Bagaimana kalau pelanggan membayar sedikit setelah QR habis?
Pembayaran yang masuk paling lambat 1 jam setelah QR habis tetap dikreditkan otomatis, walaupun halaman bayar sudah menampilkan kedaluwarsa.
Bagaimana kalau pembayaran telat atau nominalnya salah?
Pembayaran itu tidak dikreditkan otomatis dan masuk antrean tinjauan admin. Minta pelanggan menghubungi support dengan bukti transfer.
Berapa nominal maksimal per invoice gateway?
Nominal dasar maksimal Rp1.000.000 dan total yang dibayar pelanggan maksimal Rp1.000.999.
Bolehkah saya menambahkan biaya tambahan di invoice gateway?
Boleh. fee_amount opsional, harus bilangan bulat 0 ke atas, dan tidak boleh lebih besar dari nominal dasar. Biaya tambahan ini dibayar pelanggan dan masuk ke saldomu.
Apakah satu order_id bisa dipakai untuk beberapa pembayaran gateway?
Tidak. Satu order_id hanya untuk satu pembayaran gateway; kalau invoice gagal atau kedaluwarsa, buat order_id baru. Mengganti Idempotency-Key saja dijawab gateway_order_id_used.
Apa fungsi header Idempotency-Key?
Idempotency-Key wajib di setiap pembuatan invoice gateway. Mengirim ulang key dan request yang sama mengembalikan invoice yang sudah ada, sedangkan key yang sama dengan isi berbeda ditolak idempotency_key_reused.
Apakah pembayaran gateway memakai kuota request harian?
Tidak. Invoice gateway live tidak memakai kuota harian paket; batasnya per menit, ditambah batas invoice yang terbuka bersamaan.
Berapa invoice gateway yang bisa dibuat per menit?
Saat ini 60 invoice per merchant per menit. Kalau terlewat, jawabannya 429 gateway_rate_limited dengan header Retry-After.
Berapa invoice gateway yang boleh terbuka bersamaan?
Saat ini 50 invoice terbuka per merchant. Lebih dari itu ditolak gateway_open_limit sampai sebagian dibayar atau kedaluwarsa.
Apakah ada batas nominal harian untuk akun yang baru lolos KYC?
Ada pengaturannya, dan admin bisa mengaktifkannya untuk beberapa hari pertama setelah KYC disetujui. Kalau batas terlewat, jawabannya new_account_daily_amount_cap.
Berapa lama pembuatan invoice gateway paling lama?
Biasanya 1 sampai 2 detik, dan paling lama 20 detik, termasuk saat pindah ke penyedia cadangan. Kalau penyedia terlalu lambat, jawabannya 503 provider_timeout dan tidak ada QR yang dibuat. Buat ulang dengan order_id baru, dan set timeout di sisi kamu minimal 25 detik. Kalau batas tunggumu lebih pendek, kirim header X-Request-Timeout-Ms dan TemanQRIS berhenti 1 detik sebelum batas itu.
Kenapa muncul error gateway_amount_busy?
Semua kode unik untuk nominal itu sedang dipakai invoice lain yang masih terbuka. Coba lagi sebentar atau ubah nominalnya.
Bagaimana cara cek status pembayaran gateway?
Lewat webhook payment.confirmed, atau baca statusnya lewat GET /api/qris/orders/:orderId yang tidak memakai kuota.
Bisakah invoice gateway dibatalkan?
Bisa. Membatalkan atau mengarsipkan invoice gateway menutupnya, jadi pembayaran yang datang belakangan tidak lagi dikreditkan otomatis dan masuk tinjauan admin.
Bagaimana kalau pelanggan minta refund pembayaran gateway?
Refund tidak tersedia lewat API, jadi hubungi support TemanQRIS. Refund yang terjadi di sisi penyedia dicatat dan ditinjau admin.
Bisakah memakai gateway dari widget?
Bisa, dengan payment_mode: "gateway" di Widget API, dengan syarat yang sama yaitu KYC disetujui.
Bagaimana cara mulai integrasi gateway?
Mulai dari Sandbox tanpa KYC, lalu ikuti dokumentasi Buat Pembayaran dan Webhook Gateway. Setelah KYC disetujui, ganti key sandbox dengan key live.
Sandbox
Coba seluruh alur gateway tanpa uang sungguhan.
Apa itu Sandbox?
Sandbox adalah mode uji untuk mencoba seluruh alur gateway tanpa uang sungguhan: buat invoice, buka halaman bayar, simulasikan pembayaran, dan terima webhook bertanda tangan.
Apakah Sandbox butuh KYC?
Tidak. Sandbox bisa dipakai tanpa KYC.
Bagaimana mendapatkan API key Sandbox?
Buka menu Payment Gateway di dashboard lalu pilih Sandbox. Key berawalan tq_test_ dibuat saat pertama kali dibuka dan baru tampil penuh setelah kamu memasukkan password.
Bisakah QR Sandbox dibayar?
Tidak. QR Sandbox sengaja dibuat tidak bisa dibayar, dan halamannya berlabel sandbox.
Bagaimana cara mensimulasikan pembayaran di Sandbox?
Pakai tombol di halaman bayar sandbox atau API simulate untuk hasil bayar, kedaluwarsa, atau bayar telat.
Bagaimana membedakan webhook Sandbox dan live?
Webhook Sandbox membawa header X-TemanQRIS-Mode: sandbox dan ditandatangani dengan webhook secret sandbox, bukan secret live. Di produksi, tolak webhook yang mode-nya bukan live.
Berapa batas panggilan Sandbox per hari?
Saat ini 100 panggilan per merchant per hari, terpisah dari kuota live.
Berapa lama data Sandbox disimpan?
Invoice dan log webhook Sandbox disimpan 30 hari lalu dihapus otomatis. Kamu juga bisa menghapus semuanya dari console setelah memasukkan password.
Apa yang perlu diganti saat pindah dari Sandbox ke live?
Setelah KYC disetujui, ganti API key tq_test_ dengan key live dan ganti webhook secret sandbox dengan secret live. Endpoint dan isi request tetap sama.
Saldo dan penarikan
Kapan dana gateway bisa ditarik dan bagaimana prosesnya.
Apa beda saldo tersedia, tertahan, dan pending?
Saldo tersedia bisa ditarik sekarang. Saldo tertahan adalah pembayaran gateway yang baru masuk dan bisa ditarik mulai 00.00 WIB besok. Saldo pending adalah penarikan yang sudah diajukan tapi belum dibayar.
Kapan dana gateway bisa ditarik?
Mulai 00.00 WIB pada hari setelah pembayaran (H+1).
Contohnya, pembayaran pukul 23.50 WIB sudah bisa ditarik 10 menit kemudian, sedangkan pembayaran pukul 00.10 WIB menunggu hampir sehari.
Kapan penarikan diproses?
Penarikan diproses setiap hari pukul 19.45 WIB. Permintaan yang masuk pukul 19.45 WIB atau sesudahnya ikut jadwal hari berikutnya.
Ke mana saja saldo bisa ditarik?
Ke rekening bank, atau ke e-wallet DANA, GoPay, dan ShopeePay.
Berapa biaya penarikan?
Biayanya 1% dari nominal penarikan dibulatkan ke atas, minimal Rp3.000 dan maksimal Rp4.500. Contoh hitungannya ada di Biaya.
Bagaimana proses persetujuan penarikan?
Penarikan berjalan dari pending, disetujui admin, diproses, lalu dibayar. Admin bisa menolak selama penarikan belum diproses.
Kalau penarikan ditolak, uangnya ke mana?
Seluruh nominal yang diajukan, termasuk biayanya, dikembalikan ke saldo tersedia.
Bisakah saldo tertahan ditarik lebih awal?
Tidak. Hanya saldo tersedia yang bisa ditarik; saldo tertahan pindah otomatis ke saldo tersedia setelah waktunya tiba.
Kenapa wallet saya terkunci?
Wallet dikunci untuk penarikan kalau ada penarikan kembali dana akibat refund yang lebih besar dari saldo. Wallet terkunci tetap menerima pembayaran, hanya penarikannya yang diblokir sampai kekurangannya diselesaikan bersama admin.
Apakah mode manual punya saldo di TemanQRIS?
Tidak. Di mode manual uang langsung masuk ke rekening atau e-wallet QRIS-mu, jadi wallet TemanQRIS hanya dipakai untuk Gateway Otomatis.
Verifikasi KYC
Data yang dibutuhkan untuk membuka Gateway Otomatis.
Apakah KYC wajib?
KYC wajib untuk Gateway Otomatis. Mode manual dan Sandbox bisa dipakai tanpa KYC.
Data apa yang dibutuhkan untuk KYC?
Nama lengkap sesuai identitas, tanggal lahir, jenis dan nomor identitas, alamat, pekerjaan, tujuan penggunaan, sumber dana, pernyataan pemilik manfaat, dan pernyataan PEP.
Dokumen yang diunggah adalah foto identitas dan selfie sambil memegang KTP yang sama.
Identitas apa yang diterima?
KTP, paspor, atau identitas lain, dengan nomor 6 sampai 32 karakter berisi huruf, angka, atau tanda hubung.
Berapa usia minimal untuk KYC?
Minimal 17 tahun berdasarkan tanggal lahir yang diisi.
Format dokumen KYC apa yang diterima?
JPEG atau PNG, maksimal 5 MB per file, dengan dimensi gambar maksimal 8.000 piksel per sisi.
Siapa yang meninjau KYC?
KYC ditinjau manual oleh admin TemanQRIS. Kalau ditolak atau perlu perbaikan, alasannya selalu disertakan.
Apa saja status KYC?
Belum dimulai, menunggu tinjauan, perlu perbaikan, disetujui, ditolak, dan kedaluwarsa.
Apakah persetujuan KYC berlaku selamanya?
Tidak. Persetujuan KYC berlaku 365 hari, setelah itu kamu perlu mengajukan ulang.
Bisakah mengajukan KYC ulang setelah ditolak?
Bisa, selama tidak ada pengajuan yang masih menunggu tinjauan dan tidak ada persetujuan yang masih berlaku.
Bagaimana dokumen KYC disimpan?
Dokumen disimpan di penyimpanan privat yang tidak bisa diakses publik dan dienkripsi AES-256-GCM. Nomor identitas disimpan dalam bentuk hash dan versi yang disamarkan.
Untuk usaha berbadan hukum, siapa yang melakukan KYC?
KYC dilakukan oleh perwakilan yang punya wewenang atas usaha atau perusahaan tersebut.
API dan webhook
Autentikasi, kuota, dan cara memverifikasi webhook.
Bagaimana cara autentikasi API?
Kirim API key di header X-API-Key. Dashboard memakai sesi login, sedangkan integrasi server memakai API key.
Bagaimana cara melihat API key saya?
API key tampil tersamar di Pengaturan dan baru terlihat penuh setelah kamu memasukkan password. Fitur tampilkan ini dibatasi 5 kali per 15 menit.
Bagaimana cara mengganti API key?
Buat API key baru dari Pengaturan dengan memasukkan password. Key lama langsung tidak berlaku, jadi segera perbarui integrasimu.
Apakah API key disimpan dengan aman?
Ya. API key disimpan sebagai hash untuk pencocokan dan terenkripsi AES-256-GCM untuk fitur tampilkan, tidak pernah sebagai teks biasa.
Bagaimana memverifikasi webhook?
Hitung HMAC-SHA256 dari body mentah memakai webhook secret-mu, lalu bandingkan dengan header X-TemanQRIS-Signature yang berformat sha256=<hex>.
Hitung dari body mentah, bukan dari JSON yang sudah di-parse ulang. Contoh kodenya ada di Verifikasi Signature.
Header apa saja yang dikirim bersama webhook?
X-TemanQRIS-Signature, X-TemanQRIS-Event, X-TemanQRIS-Idempotency-Key, X-TemanQRIS-Mode, dan pada pengiriman ulang X-TemanQRIS-Retry.
Event webhook apa saja yang dikirim?
payment.awaiting_confirmation saat pelanggan menekan "Saya sudah bayar" di mode manual, dan payment.confirmed saat pembayaran lunas. Tidak ada event untuk kedaluwarsa, pembatalan, atau refund.
Bagaimana kalau server saya gagal menerima webhook?
Webhook dikirim ulang paling banyak 3 kali lagi, setelah 30 detik, 2 menit, dan 10 menit. Setiap percobaan dibatasi 10 detik.
Bagaimana mencegah order diproses dua kali dari webhook?
Simpan idempotency_key dari payload dan abaikan webhook dengan key yang sudah pernah diproses.
Apa syarat webhook URL?
Webhook URL wajib HTTPS dan harus mengarah ke alamat publik; alamat lokal atau privat ditolak.
Di mana saya mendapatkan webhook secret?
Buat dari Pengaturan dashboard dengan memasukkan password. Membuat secret baru langsung menggantikan yang lama.
Apa isi payload webhook gateway?
Selain order_id, nominal, dan status, webhook gateway memuat fee_amount, unique_code, total_amount, provider_fee_amount, dan net_amount supaya kamu bisa mencocokkan angkanya sendiri.
Kapan kuota API harian direset?
Setiap hari pukul 00.00 UTC atau 07.00 WIB. Request yang ditolak karena input salah tetap dihitung; hanya error server yang dikembalikan ke kuota.
Endpoint mana yang memakai kuota harian?
Upload QRIS, generate, buat dan hapus payment link, verifikasi order, dan batalkan order. Endpoint baca seperti cek QRIS, daftar link, daftar order, usage, dan status gateway tidak memakai kuota.
Bagaimana memantau sisa kuota?
Lewat GET /api/qris/usage atau header X-RateLimit-Remaining di setiap response yang memakai kuota.
Keamanan dan privasi
Perlindungan data pribadi sesuai UU PDP.
Apakah TemanQRIS mengikuti UU PDP?
Ya. Kebijakan Privasi TemanQRIS mengikuti UU No. 27 Tahun 2022 tentang Pelindungan Data Pribadi, dan persetujuan wajib dicentang saat daftar.
Apakah data saya dijual?
Tidak. TemanQRIS tidak menjual data pribadi dan hanya membagikannya bila perlu untuk layanan, kewajiban hukum, atau keamanan.
Apa hak saya atas data pribadi?
Kamu berhak meminta akses, koreksi, penghapusan, pembatasan atau keberatan, menarik persetujuan, dan mengajukan pengaduan. Ajukan lewat [email protected].
Bagaimana cara mengunduh data saya?
Saat login, panggil GET /api/user/data-export untuk mendapatkan data akun dalam format JSON, maksimal 3 kali per 24 jam. Kamu juga bisa memintanya lewat [email protected].
Bagaimana cara menghapus akun?
Ajukan dari Pengaturan dengan mengetik HAPUS dan memasukkan password. Permintaan ditinjau admin dan bisa kamu batalkan selama belum diputuskan; jika disetujui, akun dinonaktifkan dan semua akses dicabut.
Kenapa permintaan hapus akun belum bisa disetujui?
Penghapusan tertahan selama masih ada saldo wallet, penarikan yang belum selesai, atau wallet yang terkunci. Tarik saldo dulu sebelum mengajukan.
Apakah semua data langsung hilang setelah akun dihapus?
Tidak. Catatan transaksi, saldo, penarikan, KYC, dan audit tetap disimpan dengan akses terbatas selama masa retensi wajib, lalu dihapus atau dianonimkan.
Berapa lama data disimpan?
Log pembuatan QRIS dan audit transaksi 5 tahun, log webhook 1 tahun, data pemakaian API 90 hari, dan dokumen KYC 5 tahun. Nama dan catatan pembayar di invoice dianonimkan 90 hari setelah lunas.
Bagaimana password saya disimpan?
Password disimpan sebagai hash satu arah yang tidak bisa dibalik, jadi tidak pernah tersimpan dalam bentuk aslinya.
Apa yang dilakukan TemanQRIS jika terjadi kebocoran data?
TemanQRIS melakukan penanganan, investigasi, pemulihan, dan pemberitahuan kepada pengguna terdampak sesuai kewajiban hukum.
Akun dan bantuan
Daftar, masuk, dan cara menghubungi tim kami.
Apa saja yang dibutuhkan untuk mendaftar?
Nama depan dan belakang, email, password, nomor HP Indonesia, serta persetujuan Kebijakan Privasi dan Syarat & Ketentuan. Nama usaha opsional. Daftar di halaman daftar.
Format nomor HP apa yang diterima?
Nomor seluler Indonesia dengan awalan 08, 628, atau +628.
Apa aturan password?
Password minimal 8 dan maksimal 72 karakter, berlaku saat daftar maupun reset.
Apakah perlu verifikasi email sebelum bisa masuk?
Tidak. Setelah daftar, kamu langsung masuk ke dashboard.
Bagaimana kalau lupa password?
Minta link reset dari halaman lupa password. Link berlaku 1 jam dan hanya bisa dipakai sekali, dan setelah reset semua sesi lama otomatis keluar.
Kenapa ada captcha saat masuk dan daftar?
TemanQRIS memakai Cloudflare Turnstile di halaman masuk dan daftar untuk menahan spam dan bot.
Bisakah saya mengganti password dari dashboard?
Bisa, lewat menu Pengaturan dengan memasukkan password lama.
Bagaimana cara menghubungi support?
Kalau sudah punya akun, buat tiket di menu Bantuan dashboard supaya data akunmu ikut tercatat. Belum punya akun? Pakai halaman kontak atau email [email protected].
Apakah ada support lewat WhatsApp?
Ada. Tombol WhatsApp di dashboard membuka chat langsung dengan admin.
Ke mana saya mengirim pertanyaan soal privasi?
Coba kata lain, misalnya "biaya", "saldo", atau "webhook", atau tanyakan langsung ke tim kami di bawah.
Pertanyaanmu belum terjawab?
Kalau sudah punya akun, buat tiket dari dashboard supaya data akunmu ikut terbaca. Belum punya akun? Kirim pesan lewat halaman kontak atau email [email protected].