Qris API
Qris API on Singapay Payment Gateway
QRIS (Quick Response Code Indonesian Standard) is a standardized QR payment system in Indonesia that enables cashless payments using QR codes. Unlike Virtual Account or Payment Link which can receive multiple payments, each QRIS code is generated for a single specific transaction with a fixed amount.
💡 QRIS Payment Flow
Key Difference: One QR = One Transaction
Unlike VA or Payment Link, each QRIS code is only valid for ONE payment
Cannot Do
- • Reuse the same QR code multiple times
- • Receive partial payments
- • Change the amount after generation
- • Keep QR code active indefinitely
Must Do
- • Generate new QR for each transaction
- • Set correct amount at creation time
- • Monitor payment status in real-time
- • Use for single, fixed-amount payments
Remember: After a customer pays, the QRIS code expires and cannot be reused. Generate a new QR code for the next customer.
Important Notes
- • One-Time Use: Each QRIS code can only be used once. After payment, the QR code cannot be reused.
- • Amount Fixed: Payment amount is fixed at generation time. Customer must pay exact amount.
- • Expiration: QRIS codes can have optional expiration time. After expiry, the code cannot be used.
- • MDR Fees: Merchant Discount Rate (MDR) applies to QRIS transactions. Fee percentage depends on your merchant category and agreement.
- • Delete Restriction: Only QRIS codes with status "open" (unpaid) can be deleted. Paid codes cannot be deleted.
- • Settlement Time: QRIS settlement time depends on payment provider (H+1 to H+2 typically).
- • Transaction History: Records are retained for 1 year. Data older than 1 year is archived.