QRIS API: a dynamic QRIS for every transaction.
Create a QRIS code with a locked amount in one request, show it on your website or app, and receive a webhook once the buyer pays.
Try it first with a test key and no real money.
curl https://api.fintar.id/v1/transactions \
-H "Authorization: Bearer ft_test_..." \
-H "Idempotency-Key: order-1234" \
-H "Content-Type: application/json" \
-d '{
"order_items": [
{ "name": "Kaos polos", "price": 75000, "quantity": 2 }
],
"external_id": "ORD-1234",
"payment_methods": ["qris"],
"customer": { "name": "Budi", "email": "budi@toko.dev" }
}'
Rp 150.000
Three steps from order to paid.
Create the transaction
Send POST /v1/transactions with "qris" in payment_methods. The response carries a qr_string.
Show the QR
Render qr_string as a QR image on your own page. The amount is locked, so the buyer types nothing.
Receive the webhook
The payment.paid event is sent to your server once the payment succeeds. You can also check GET /v1/transactions/:id.
One code, every payment app.
- Every QRIS app. One code is accepted by GoPay, OVO, DANA, ShopeePay, LinkAja and bank apps that support QRIS.
- Fast confirmation. Confirmation arrives seconds after the code is scanned and paid.
- No buyer data. QRIS does not require the buyer's name or email.
- Rp1,000 to Rp10,000,000. The default amount limits per QRIS payment.
- Adjustable expiry. 60 minutes by default, and up to 24 hours through expires_in_minutes.
{
"id": "payreq_9b2f...",
"status": "pending",
"payment_method": "qris",
"payment": {
"type": "qr",
"qr_string": "00020101021226670016COM.FINTAR.WWW...6304A1B2"
},
"expires_at": "2026-08-27T13:00:00+07:00"
}
Dynamic QRIS and static QRIS: what is the difference?
A static QRIS is one fixed code that is printed and reused. The buyer types the amount, and the seller matches each payment by hand.
A dynamic QRIS is created fresh for every transaction with the amount already locked, so the system knows exactly which order was paid.
The Fintar QRIS API produces dynamic QRIS codes. Because each code is tied to one transaction, your website or app can mark the order paid automatically when the webhook arrives, without checking bank statements.
Questions about the QRIS API
Can a Fintar QRIS be paid from every e-wallet?
Yes, from bank and e-wallet apps that support QRIS, including GoPay, OVO, DANA, ShopeePay and LinkAja.
What are the minimum and maximum QRIS amounts?
A minimum of Rp1,000 and a maximum of Rp10,000,000 per payment. The limits in force for an account are always available from GET /v1/payment_methods.
How long is a QRIS code valid?
60 minutes from creation by default. The expiry can be set through expires_in_minutes, up to 24 hours.
How do I test QRIS without real money?
Use a test key starting with ft_test_. In Sandbox a payment can be simulated as paid or expired without a real scan.
Can a QRIS payment be refunded?
A QRIS payment cannot be reversed or refunded through Fintar. The merchant returns the money by transfer from their own bank account, outside Fintar.
Can I print an API QRIS to display in a store?
No. A QRIS from the API is valid for one transaction with a set amount. For the next buyer, create a new transaction.
Accept QRIS on your own website.
Create an account, grab a test key and show your first QRIS in minutes.