# PinnPay Shopee Gateway

> Gateway QRIS (ShopeePay Merchant). Buat QRIS dinamis per nominal, deteksi pembayaran otomatis, kirim webhook bertanda tangan HMAC-SHA256.

Hal terpenting: tampilkan `nominal` dari respons `POST /api/pay` kepada pelanggan (bisa +Rp 1-99 dari yang diminta agar unik); apikey hanya di server; verifikasi `X-PinnPay-Signature` pada raw body; idempoten berdasarkan `tx_id`.

## Dokumentasi
- [Dokumentasi lengkap (Markdown)](https://pinnduit.my.id/docs.md): endpoint, skema, webhook, contoh kode, panduan untuk agen AI
- [OpenAPI 3.1](https://pinnduit.my.id/openapi.json): spesifikasi mesin-terbaca untuk /api/pay, /api/status, /health dan webhook
- [Dokumentasi (HTML)](https://pinnduit.my.id/docs): versi web untuk manusia

## Endpoint ringkas
- POST https://pinnduit.my.id/api/pay  body {client_id, apikey, nominal, order_ref?} -> {tx_id, nominal, base_nominal, unique_add, qris_payload, expired_at, status}
- GET https://pinnduit.my.id/api/status/{tx_id}  header X-Client-Id, X-Api-Key -> {status: PENDING|PAID|EXPIRED, ...}
- GET https://pinnduit.my.id/health

## Optional
- Panel admin (internal, butuh ADMIN_TOKEN): https://pinnduit.my.id/dashboard