Panduan & FAQ Escrow Coinawe

🔑 Fitur Utama

• Layanan Escrow Terstruktur: Proses transaksi jelas, dari inisiasi hingga pelepasan dana.
• Peran Pengguna:
  • Pengguna Biasa: Membuat dan berpartisipasi dalam transaksi escrow.
  • Admin: Verifikasi pembayaran, penyelesaian sengketa, pelepasan dana.
  • Superadmin: Hak penuh, termasuk manajemen admin dan broadcast.
• Dukungan Multi-Bahasa: Bahasa Indonesia (id) & Inggris (en).
• Dukungan Aset Kripto: TON & AWEWE.
• Fitur Otomatisasi: Pembatalan otomatis & pengingat pelepasan dana.

🔄 Ringkasan Alur Transaksi

1. Inisiasi & Persetujuan: Pengguna memilih peran, memasukkan detail, lawan transaksi menyetujui atau menolak.
2. Pembayaran: Status PENDING_PAYMENT, batas waktu 30 menit.
3. Verifikasi Admin: Pembeli kirim TXhash, status WAITING_VERIFICATION.
4. Pengiriman Barang/Jasa: Status WAITING_DELIVERY → Penjual kirim & unggah bukti → WAITING_CONFIRMATION.
5. Konfirmasi Pembeli: Pembeli menekan tombol Konfirmasi Barang Diterima.
6. Pelepasan Dana: Status WAITING_PAYOUT, penjual kirim wallet, admin transfer & unggah TXhash.
7. Transaksi Selesai: Status COMPLETED, notifikasi ke kedua pihak.
8. Sengketa (Dispute): Status ON_DISPUTE, admin menengahi & memutuskan.

📜 Detail Alur Transaksi

Berikut adalah rincian setiap langkah dalam proses escrow, dari awal hingga selesai, untuk Pembeli dan Penjual.

🛒 Alur untuk Pembeli (Buyer)

1. Memulai Escrow:
   Pilih menu "➕ Buat Escrow" > "👤 Pembeli". Bot akan meminta Anda memasukkan detail transaksi dalam format:
   @username_penjual jumlah nama_barang
2. Masukkan Nominal:
   Setelah itu, masukkan jumlah dan jenis token, contohnya:
   100 TON
   Bot akan membuat permintaan escrow dan mengirimkannya ke penjual.
3. Menunggu Persetujuan Penjual:
   Status escrow saat ini adalah PENDING_USER. Anda tinggal menunggu penjual menekan tombol "✅ Setujui". Jika penjual menolak, escrow akan dibatalkan.
4. Melakukan Pembayaran:
   Setelah penjual setuju, status berubah menjadi PENDING_PAYMENT. Anda akan menerima pesan berisi jumlah total yang harus dibayar (termasuk fee) dan alamat wallet bot. Batas waktu pembayaran adalah 30 menit.
5. Kirim Bukti Transfer (TXhash):
   Setelah mentransfer dana, balas pesan bot dengan mengirimkan TXhash (Transaction Hash) dari pengiriman Anda.
6. Menunggu Verifikasi Admin:
   Status berubah menjadi WAITING_VERIFICATION. Admin akan memeriksa bukti transfer Anda. Anda akan diberi tahu jika pembayaran sudah dikonfirmasi.
7. Menunggu Pengiriman Barang:
   Setelah pembayaran terverifikasi, status berubah menjadi WAITING_DELIVERY. Penjual diinstruksikan untuk mengirimkan barang/jasa.
8. Menerima Bukti & Konfirmasi Barang:
   Saat penjual mengirim barang, Anda akan menerima notifikasi berisi bukti pengiriman dari penjual. Status berubah menjadi WAITING_CONFIRMATION. Setelah Anda menerima barang/jasa dengan baik, tekan tombol "✅ Konfirmasi Barang Diterima".
9. Transaksi Selesai:
   Status berubah menjadi COMPLETED. Dana akan diteruskan ke penjual dan proses escrow Anda selesai.

📦 Alur untuk Penjual (Seller)

1. Menerima & Menyetujui Permintaan:
   Anda akan menerima notifikasi permintaan escrow dari pembeli. Periksa detailnya, lalu tekan "✅ Setujui" untuk melanjutkan atau "❌ Tolak" untuk membatalkan.
2. Menunggu Pembayaran Pembeli:
   Status berubah menjadi PENDING_PAYMENT. Anda tinggal menunggu pembeli melakukan pembayaran dan admin memverifikasinya.
3. Mengirim Barang/Jasa:
   Setelah pembayaran terverifikasi oleh admin, Anda akan menerima notifikasi bahwa dana sudah aman. Status menjadi WAITING_DELIVERY. Segera kirim barang/jasa kepada pembeli, lalu tekan tombol "📦 Barang Telah Dikirim".
4. Kirim Bukti Pengiriman:
   Status berubah menjadi WAITING_SHIPMENT_PROOF. Bot akan meminta Anda untuk mengirimkan bukti pengiriman (contoh: resi, screenshot, foto). Kirimkan bukti tersebut sebagai balasan.
5. Menunggu Konfirmasi Pembeli:
   Bukti Anda akan diteruskan ke pembeli dan status berubah menjadi WAITING_CONFIRMATION. Anda tinggal menunggu pembeli menekan tombol konfirmasi setelah mereka menerima barang.
6. Memberikan Alamat Wallet:
   Setelah pembeli konfirmasi, status berubah menjadi WAITING_PAYOUT. Bot akan meminta Anda mengirimkan alamat wallet (TON atau AWEWE) untuk menerima dana.
7. Menerima Dana:
   Setelah Anda memberikan wallet, admin akan mentransfer dana dan mengirimkan TXhash sebagai bukti. Status berubah menjadi COMPLETED dan transaksi selesai.

🧑‍💻 Peran & Perintah

Pengguna Umum

• /start – Memulai atau reset interaksi.
• /history – Menampilkan riwayat transaksi terakhir.
• /myid – Informasi profil pengguna.
• /admin_list – Menampilkan daftar admin & superadmin.
• /cancel – Membatalkan proses escrow berjalan.

Admin

• /admin – Menu admin.
• /release [ID Escrow] [TXhash] – Rilis dana manual untuk transaksi WAITING_PAYOUT.

Superadmin

• /broadcast [pesan] – Broadcast ke semua pengguna.
• /addadmin [USER_ID] – Tambah admin baru.
• /removeadmin [USER_ID] – Hapus admin.

❓ FAQ (Pertanyaan Umum)

Umum

Apa itu Coinawe Bot?
Coinawe adalah layanan penengah (escrow) otomatis yang mengamankan transaksi Anda. Kami bertindak sebagai pihak ketiga netral yang menahan dana hingga kedua belah pihak puas.

Berapa lama batas waktu pembayaran?
Anda memiliki batas waktu tertentu (misalnya, 6 jam) untuk membayar. Jika terlewat, transaksi otomatis batal.

Bagaimana jika saya sudah mengirim dana ke bot tapi lawan transaksi menghilang?
Tenang, dana Anda aman. Tujuan utama escrow adalah melindungi dana jika salah satu pihak menghilang. Jika lawan transaksi tidak melanjutkan escrow, bot akan membatalkannya secara otomatis setelah batas waktu tercapai dan admin akan memproses pengembalian dana Anda.

Untuk Pembeli

Bagaimana jika Penjual tidak merespons permintaan escrow?
Jika penjual tidak menyetujui escrow dalam batas waktu, transaksi akan dibatalkan secara otomatis. Anda tidak perlu melakukan apa-apa.

Bisakah saya membatalkan escrow?
Anda bisa membatalkan escrow kapan saja SEBELUM melakukan pembayaran. Setelah pembayaran diverifikasi, pembatalan sepihak tidak bisa dilakukan.

Untuk Penjual

Bagaimana jika Pembeli tidak membayar?
Jika pembeli tidak membayar dalam batas waktu, transaksi otomatis dibatalkan oleh bot. Anda bisa bertransaksi dengan orang lain.

Kapan saya menerima dana?
Segera setelah pembeli mengonfirmasi penerimaan barang, admin akan memproses pencairan dana (payout). Anda akan diberi notifikasi beserta TXhash.

⚙️ Aspek Teknis & Otomatisasi

• Platform: Google Apps Script (GAS).
• Database: Google Sheets (Users, Escrow, Logs).

Fungsi Otomatis

• checkPaymentTimeouts – Membatalkan escrow yang belum dibayar (15 menit sekali).
• checkStuckPayouts – Mengingatkan admin jika pelepasan dana tertunda (5 menit sekali).
• clearInactiveStates – Membersihkan state pengguna yang tidak aktif (1 jam sekali).
• processBroadcastQueue – Mengatur antrian broadcast agar tidak melebihi batas API Telegram.