Skip to content
QRIS API

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.

Create a QRISPOST /v1/transactions
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" }
  }'
Payment received

Rp 150.000

QRISPaid
Sample transaction
How it works

Three steps from order to paid.

  1. Create the transaction

    Send POST /v1/transactions with "qris" in payment_methods. The response carries a qr_string.

  2. Show the QR

    Render qr_string as a QR image on your own page. The amount is locked, so the buyer types nothing.

  3. Receive the webhook

    The payment.paid event is sent to your server once the payment succeeds. You can also check GET /v1/transactions/:id.

What you get

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.
Response201 Created
{
  "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"
}
Basics

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.

FAQ

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.