# TemanQRIS

> TemanQRIS adalah platform generator QRIS dinamis Indonesia #1 untuk UMKM, developer, dan bisnis. Konversi QRIS statis ke QRIS dinamis dengan mudah — buat payment gateway sendiri seharga es teh! API QRIS gratis, widget embeddable, webhook realtime, tanpa MDR, tanpa potongan.

Kunjungi https://temanqris.com untuk mendaftar. Dapatkan API key gratis di https://temanqris.com/dashboard/settings.

## Halaman publik
- [Homepage](https://temanqris.com/): generator QRIS dinamis, pricing, fitur
- [Dokumentasi API](https://temanqris.com/docs): referensi lengkap API QRIS v1.2.1, use case, dan contoh full backend flow
- [Tutorial](https://temanqris.com/tutorial): panduan langkah-demi-langkah untuk QRIS dinamis, payment link, webhook, callback URL, dan widget
- [Blog](https://temanqris.com/blog): artikel edukasi QRIS, payment gateway, tips bisnis
- [FAQ — Apa itu QRIS Dinamis?](https://temanqris.com/blog/qris-statis-vs-dinamis)
- [FAQ — Generator QRIS Gratis](https://temanqris.com/blog/qris-generator-gratis-tanpa-fee)
- [FAQ — Keuntungan QRIS Dinamis](https://temanqris.com/blog/keuntungan-pakai-qris-dinamis)
- [Terima Pembayaran Tanpa Potongan](https://temanqris.com/blog/terima-pembayaran-tanpa-potongan)
- [Syarat & Ketentuan](https://temanqris.com/terms)
- [Kebijakan Privasi](https://temanqris.com/privacy)

## API
- Version: API v1.2.1
- Base URL: `https://temanqris.com/api`
- Autentikasi: Header `X-API-Key: <your_api_key>` atau query param `?api_key=<key>`
- Rate limit: 50 request/hari (Free), 1000/hari (Premium)
- Usage accounting: limit mengikuti admin settings, quota dihitung per user per hari, dan response error direfund agar tidak false positive
- Docs mobile: navigasi dokumentasi tetap tersedia sebagai sticky horizontal nav di tablet dan mobile
- Use case utama: e-commerce checkout, invoice freelancer/agency, SaaS billing, top up saldo, order dari WhatsApp/Telegram/CRM

### Endpoint utama
- `POST /api/qris/generate` — konversi QRIS statis ke dinamis dengan amount dan fee
- `GET /api/qris/my-qris` — cek apakah merchant sudah punya QRIS statis
- `POST /api/qris/upload` — upload QRIS statis merchant
- `POST /api/qris/payment-link` — buat payment link QRIS per order
- `GET /api/qris/orders/:orderId` — cek status order dari backend
- `POST /api/qris/orders/:orderId/verify` — verifikasi pembayaran setelah dana benar-benar masuk
- `GET /api/qris/usage` — cek pemakaian request API
- `GET /api/qris/history` — riwayat QRIS yang di-generate
- `POST /api/widget/generate` — generate via embeddable widget (CORS open)
- Payment Links: buat link pembayaran via dashboard, pelanggan bayar via `/p/:code`

### Webhook
- Event: `payment.awaiting_confirmation`, `payment.confirmed`
- Payload ditandatangani dengan HMAC-SHA256 (`X-Webhook-Signature`)
- Retry otomatis hingga 3x jika gagal

## Harga
- **Free**: Rp 0/bulan — 50 request/hari, 1 merchant, API access
- **Premium**: Rp 9.000/bulan — 1000 request/hari, unlimited merchant, priority support, analytics

## Tentang
- Platform: SaaS payment gateway Indonesia
- Operator: TemanQRIS by [PT. INOVASI KSATRIA INDONESIA](https://ksatriacorp.com)
- Lokasi: Malang, Jawa Timur, Indonesia
- Kontak: support@temanqris.com
- Teknologi: Node.js, Express, MySQL, QRIS standar Bank Indonesia

## Optional
- [Sitemap](https://temanqris.com/sitemap.xml)
- [Robots](https://temanqris.com/robots.txt)