API ini digunakan untuk menampilkan Nominal Transaksi QRIS pada aplikasi Anda agar dapat digunakan oleh pengguna aplikasi untuk membayar/scan transaksi menggunakan metode QRIS.
Nominal Transaksi berupa Total Transaksi yang akan dibayar dan harus ditentukan dari aplikasi Anda.
Aplikasi Anda akan mendapatkan Konten QRIS (qris_content) yang dapat dimanfaatkan untuk menampilkan QR Code sesuai dengan library yang digunakan pada Bahasa Pemrograman yang Anda gunakan.
Disarankan untuk menyimpan Konten QRIS (qris_content), tanggal generate (qris_request_date) dan Invoice ID (qris_invoiceid) ke database Anda yang nanti dapat dimanfaatkan untuk menampilkan ulang sebelum Konten teks QRIS tersebut Expired dan Invoice ID (qris_invoiceid) dapat digunakan untuk memeriksa status pembayaran QRIS.
Batas waktu kadaluarsa (expired) 60 menit semenjak QRIS ditampilkan. Saat Expired maka QRIS akan gagal saat di-scan oleh pengguna.
Nominal Transaksi yang dapat digunakan untuk scan QRIS berbeda-beda minimal dan maksimalnya.
Maksimal jumlah transaksi biasanya adalah Rp.2.000.000 atau juga bisa lebih tergantung dari Jenis Akun pengguna disetiap aplikasi e-wallet.
GET
https://qris.id/restapi/qris/show_qris.php
| variable | type | example value | required |
|---|---|---|---|
| do | string | create-invoice | required |
| apikey | string | a789789 | required |
| mID | integer | 123456 | required |
| cliTrxNumber | string | PJ0099 | required |
| cliTrxAmount | integer | 10000 | required |
Harap diperhatikan bahwa API QRIS ini sifatnya adalah LIVE / PRODUCTION, saat Anda melakukan SCAN terhadap QRIS yang muncul, maka saldo e-wallet Anda akan benar-benar berkurang dan tidak dapat dikembalikan (tidak ada refund).
{
"status": "success",
"data": {
"qris_content": "00020101021226680016ID.CO.TELKOM.WWW011893600898025599662702150001952559966270303UMI51440014ID.CO.QRIS.WWW0215ID10200211817450303UMI520457325303360540825578.005502015802ID5916InterActive Corp6013KOTA SURABAYA61056013662130509413255111630439B7",
"qris_request_date": "2020-08-07 11:13:42",
"qris_invoiceid": "413255111",
"qris_nmid": "ID1020021181745"
}
}
Dalam Response diatas Anda akan mendapatkan Response Konten QRIS (qris_content) yang dapat dimanfaatkan untuk menampilkan QR Code sesuai dengan library yang digunakan pada Bahasa Pemrograman yang Anda gunakan.
Invoice ID (qris_invoiceid) adalah Nomor Transaksi QRIS yang berupa integer yang dapat digunakan untuk memeriksa status pembayaran QRIS.
Batas waktu kadaluarsa (expired) 60 menit (dalam WIB atau GMT+7) semenjak QRIS ditampilkan, Anda dapat memanfaatkan (qris_request_date) untuk acuan menghitung expired. Saat Expired maka QRIS akan gagal saat di-scan oleh pengguna.
{
"status": "failed",
"data": {
"qris_status": "invalid amount / invalid apikey / invalid mID / transcation number is empty / what we do for you?"
}
}