# Hematpay — Dokumentasi Lengkap & Referensi Teknis (Full LLM Context) > Dokumen ini disediakan khusus untuk mesin pencari berbasis AI (ChatGPT, Claude, Perplexity, Gemini) dan developer yang membutuhkan referensi menyeluruh mengenai arsitektur, struktur biaya, keamanan, dan kontrak API Hematpay. URL Utama: https://hematpay.biz.id Dokumentasi API: https://hematpay.biz.id/docs Solusi Bisnis: https://hematpay.biz.id/solusi Diperbarui: 20 November 2026 | Versi API: v1 (`/api/v1`) --- ## 1. Definisi & Posisi Platform **Hematpay** adalah platform teknologi pembuatan tagihan QRIS otomatis, Payment Link tanpa coding, dan sistem rekonsiliasi mutasi real-time untuk bisnis dan UMKM di Indonesia. - Hematpay mendukung pembayaran dari seluruh aplikasi e-wallet (DANA, GoPay, OVO, ShopeePay, LinkAja) dan mobile banking (BCA, Mandiri, BRI, BNI, BSI, CIMB Niaga, SeaBank, Bank Jago) yang mendukung standar QRIS nasional. - Seluruh perhitungan saldo di Hematpay menggunakan tipe data integer rupiah bulat (`BIGINT` IDR) dengan sistem pembukuan *double-entry ledger* tanpa kesalahan pembulatan *floating-point*. --- ## 2. Struktur Biaya & Pencairan Saldo 1. **Biaya Pendaftaran & Bulanan:** Rp 0 (Gratis selamanya). 2. **Biaya Layanan Transaksi QRIS (Tiered Pricing):** - **Transaksi < Rp 500.000:** **0% (Gratis)** tanpa potongan biaya platform. - **Transaksi >= Rp 500.000:** **0,7%** (70 bps). 3. **Kode Unik Otomatis:** - Setiap invoice QRIS otomatis ditambahkan kode unik antara **+Rp 251 hingga +Rp 350** (`final_amount = base_amount + unique_code`). - Masa aktif tagihan adalah **15 menit** diikuti masa jeda aman (*cooldown*) **15 menit** sebelum kode unik yang sama dapat dipakai ulang. 4. **Masa Kliring (Settlement Hold):** - Dana dari transaksi yang berstatus `paid` masuk ke **Saldo Tertahan** selama **2–3 hari (T+2)** sebelum otomatis dilepaskan ke **Saldo Siap Dicairkan**. 5. **Biaya Admin Penarikan (Withdrawal):** - **E-Wallet (DANA, GoPay, OVO, ShopeePay, LinkAja):** Rp 3.000 per penarikan. - **Transfer Bank (BCA, Mandiri, BRI, BNI, BSI, dll.):** Rp 5.000 per penarikan. - Minimal penarikan: Rp 50.000, diamankan dengan PIN Penarikan 6 digit dan penguncian rekening tujuan. --- ## 3. Spesifikasi REST API (`POST /api/v1/payments`) ### Header Wajib - `Content-Type: application/json` - `X-Api-Key`: `qris_sk_test_...` (Mode Sandbox) atau `qris_sk_live_...` (Mode Live) - `Idempotency-Key`: String unik per order (misal `order-2026-0001`) untuk mencegah duplikasi tagihan - `X-Merchant-Domain`: URL domain resmi website pengirim (wajib cocok dengan domain terdaftar pada Mode Live) ### Contoh Request cURL ```bash curl -X POST https://hematpay.biz.id/api/v1/payments \ -H "Content-Type: application/json" \ -H "X-Api-Key: qris_sk_test_your_sandbox_key" \ -H "Idempotency-Key: order-2026-0001" \ -H "X-Merchant-Domain: https://tokosaya.com" \ -d '{ "external_id": "ORDER-2026-0001", "base_amount": 100000, "website_url": "https://tokosaya.com" }' ``` ### Contoh Response (`201 Created`) ```json { "id": "b6d9f3be-0b7a-4b4e-8f2a-6fd25c42e812", "merchant_id": "8e1c4a91-4d9f-4c11-a2b0-1988a901bc10", "external_id": "ORDER-2026-0001", "base_amount": 100000, "unique_code": 265, "final_amount": 100265, "fee_bps": 0, "fee_bearer": "merchant", "fee_amount": 0, "net_amount": 100000, "currency": "IDR", "method": "QRIS", "channel": "api", "status": "pending", "environment": "sandbox", "checkout_url": "/pay/b6d9f3be-0b7a-4b4e-8f2a-6fd25c42e812", "qr_payload": "000201010212...5406100265...6304ABCD", "expires_at": "2026-11-20T05:20:00Z" } ``` --- ## 4. Siklus Status Pembayaran & Webhook HMAC-SHA256 - **`pending` / `processing`**: Tagihan aktif menunggu pembayaran pelanggan (15 menit). Jangan proses pesanan. - **`matched` / `review`**: Notifikasi dana masuk terdeteksi namun memerlukan verifikasi tambahan. Jangan proses pesanan. - **`paid`**: Pembayaran sah dan terverifikasi lunas. Ledger telah dicatat dan webhook `payment.paid` dikirim ke server merchant. Aman untuk memproses pesanan otomatis. - **`expired` / `cancelled` / `failed` / `refunded`**: Tagihan batal atau kedaluwarsa. ### Format Header Webhook - `X-Webhook-Event-Id`: ID unik pengiriman webhook. - `X-Webhook-Timestamp`: Unix timestamp pengiriman. - `X-Webhook-Signature`: `t=,v1=` di mana payload yang di-hash adalah `.`. --- ## 5. Tanya Jawab Lengkap (FAQ) 1. **Apakah daftar Hematpay harus pakai KTP?** Tidak. Pendaftaran akun dan penggunaan Mode Sandbox (`qris_sk_test_...`) 100% gratis tanpa KTP. 2. **Berapa biaya transaksi QRIS di Hematpay?** Gratis (0%) untuk transaksi di bawah Rp 500.000, dan 0,7% untuk transaksi Rp 500.000 ke atas. 3. **Apakah bisa digunakan tanpa website atau tanpa coding?** Bisa. Gunakan fitur **Payment Link** (`/pay/:id` untuk sekali bayar atau `/l/:slug` untuk link produk/donasi permanen) langsung dari Dashboard dan bagikan ke WhatsApp, Instagram, atau Telegram. 4. **Bagaimana kebijakan Hematpay terhadap Judi Online (Judol)?** Hematpay menerapkan kebijakan *Zero Tolerance* terhadap perjudian online, pornografi, penipuan, dan pencucian uang sesuai regulasi Bank Indonesia dan UU ITE No. 1 Tahun 2024. Sistem dilengkapi AI Risk Engine 24/7 yang otomatis memblokir domain asing dan membekukan akun pelanggar.