# TemanQRIS — Generator QRIS Dinamis Indonesia

> Platform SaaS #1 Indonesia untuk konversi QRIS statis ke QRIS dinamis. Buat payment gateway sendiri dengan mudah dan murah — mulai Rp 9.000/bulan. API QRIS gratis, tanpa MDR, tanpa potongan, webhook realtime.

## Apa itu TemanQRIS?

TemanQRIS membantu pelaku usaha Indonesia (UMKM, developer, freelancer, toko online) menerima pembayaran digital melalui QRIS dinamis. Dengan TemanQRIS, Anda bisa:

- **Mengkonversi QRIS statis ke dinamis** — masukkan nominal otomatis, tidak perlu input manual
- **Buat payment gateway sendiri** — integrasikan via API atau widget embeddable
- **Terima pembayaran dari semua e-wallet dan bank** — GoPay, OVO, DANA, ShopeePay, LinkAja, BCA, BNI, BRI, Mandiri, BSI
- **Tanpa potongan MDR** — dana masuk 100% langsung ke rekening merchant Anda
- **Payment link instan** — bagikan link pembayaran ke pelanggan tanpa coding

## Harga

| Tier | Harga | Request/Hari | Merchant | Fitur |
|------|-------|-------------|----------|-------|
| Free | Rp 0 | 50 | 1 | API, Widget, Dashboard |
| Premium | Rp 9.000/bln | 1.000 | Unlimited | + Priority support, Analytics, Webhook |

## Cara Kerja

1. Daftar akun gratis di temanqris.com
2. Upload atau paste QRIS statis dari bank/e-wallet Anda
3. Masukkan nominal → sistem generate QRIS dinamis otomatis
4. Bagikan QR code atau payment link ke pelanggan
5. Pelanggan scan dan bayar → notifikasi webhook ke server Anda

## API Reference v1.2.1 (ringkasan)

**Base URL:** `https://temanqris.com/api`

**Versi:** API v1.2.1

**Autentikasi:** `X-API-Key: <your_api_key>` header

**Rate limit default:** Free 50 request/hari, Premium 1000 request/hari. Nilai production mengikuti admin settings di TemanQRIS.

**Use case umum:** e-commerce checkout, invoice freelancer/agency, SaaS billing, top up saldo, order WhatsApp/Telegram/CRM, dan payment link untuk sales team.

### Generate QRIS Dinamis
```
POST /api/qris/generate
Content-Type: application/json
X-API-Key: your_api_key

{
  "qris_string": "00020101021226...",
  "amount": 50000,
  "fee_type": "none"
}

Response: { "success": true, "qris": "00020101021226...", "qr_image": "data:image/png;base64,..." }
```

### Payment Links
Buat via dashboard atau API `POST /api/qris/payment-link` → pelanggan bayar di `https://temanqris.com/p/{code}` → webhook `payment.awaiting_confirmation` dikirim ke URL Anda → backend cek `GET /api/qris/orders/:orderId` → admin atau sistem internal verify dengan `POST /api/qris/orders/:orderId/verify` setelah dana masuk.

Contoh request:
```bash
curl -X POST https://temanqris.com/api/qris/payment-link \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 125000,
    "description": "Checkout Order INV-2026-0001",
    "order_id": "INV-2026-0001",
    "webhook_url": "https://company.com/webhooks/temanqris",
    "callback_url": "https://company.com/orders/INV-2026-0001/thank-you"
  }'
```

### API Usage Accounting
`GET /api/qris/usage` menampilkan pemakaian harian dan bulanan berdasarkan limit tier yang disetel admin. Sistem usage memakai reservasi quota per user per hari dan mengembalikan quota untuk response error, sehingga angka request tidak melonjak karena false positive.

### Widget Embeddable
```html
<script src="https://temanqris.com/widget.js"></script>
<div id="temanqris-widget" data-api-key="YOUR_KEY" data-amount="50000"></div>
```

## Target Pasar

- UMKM yang sudah punya QRIS statis tapi butuh nominal otomatis
- Developer yang butuh payment gateway murah untuk integrasi
- Toko online / e-commerce yang mau terima QRIS tanpa biaya MDR
- Freelancer dan content creator untuk invoice otomatis
- Reseller dan dropshipper untuk pembayaran COD digital

## Keunggulan vs Kompetitor

- **Termurah**: Rp 9.000/bulan vs Midtrans/Xendit/Doku yang charge per-transaksi
- **Tanpa MDR**: Dana masuk 100% (kompetitor potong 0.7%-1.5%)
- **Self-service**: Daftar langsung pakai, tanpa approval process berhari-hari
- **Open CORS Widget**: Embed di website manapun tanpa backend
- **Webhook realtime**: Notifikasi instan saat pelanggan bayar

## Informasi Operator

- **Platform**: TemanQRIS (temanqris.com)
- **Operator**: [PT. INOVASI KSATRIA INDONESIA](https://ksatriacorp.com)
- **Lokasi**: Malang, Jawa Timur, Indonesia
- **Kontak**: support@temanqris.com
- **Standar**: QRIS Bank Indonesia (BI), mendukung semua PSP terdaftar

## Tautan Penting

- Website: https://temanqris.com
- Dokumentasi: https://temanqris.com/docs
- Tutorial: https://temanqris.com/tutorial — panduan QRIS dinamis, payment link, webhook, callback URL, dan widget
- Blog: https://temanqris.com/blog
- Sitemap: https://temanqris.com/sitemap.xml