Overview

Quick Response Code Indonesian Standard atau disingkat QRIS (dibaca KRIS) adalah penyatuan berbagai macam QR dari berbagai Penyelenggara Jasa Sistem Pembayaran (PJSP) menggunakan QR Code. QRIS dikembangkan oleh industri sistem pembayaran bersama dengan Bank Indonesia agar proses transaksi dengan QR Code dapat lebih mudah, cepat, dan terjag​a keamanannya.

Dengan QRIS, seluruh aplikasi pembayaran dari Penyelenggara manapun baik bank dan nonbank yang digunakan masyarakat, dapat digunakan di seluruh toko, pedagang, warung, parkir, tiket wisata, donasi (merchant) berlogo QRIS, meskipun penyedia QRIS di merchant berbeda dengan penyedia aplikasi yang digunakan masyarakat.

Apa itu QRIS MPM

QRIS Merchant Presented Mode (MPM) merupakan mode pembayaran QRIS yang paling umum digunakan. Dengan metode ini pembeli akan melakukan scan pada barcode QR dari penjual untuk melakukan pembayaran. Model pembayaran ini sama dengan QR pada umumnya di mana penjual yang menyediakan barcode QRIS.

Sequence Diagram

Bagian berikut akan menjelaskan tentang detail teknis untuk setiap proses dalam layanan ini.

Description:

No	Proses	Dok Terkait	Deskripsi
1	Request Generate QRIS	Generate QRIS	Disini Merchant / partner melakukan request generate QRIS
2	Return QRIS URL		SpeedCash Mengirimkan respon berupa url QRIS
3	Show QRIS		Dari Sistem partner menampilkan qris ke merchant yang di dapat dari speedCash
4	Scan & payment		User melakukan scan QRIS dan Payment ke pada merchant
5	Callback Payment success	Callback Payment	SpeedCash mendeteksi pembayaran sukses dan mengirimkan callback ke partner
6	Notify Payment success		Partner mengirimkan notify pembayaran sukses ke merchant

Standar Keamanan Transaksi

Untuk memastikan keamanan transaksi, QRIS MPM menggunakan standar keamanan yang telah ditetapkan oleh Bank Indonesia, yaitu dengan menggunakan signature dan enkripsi. Winpay menggunakan type Asymmetric Without Get Token dan Asymmetric with token untuk menghasilkan signature, Signature tersebut dikirimkan melalui header X-Signature pada saat request.

Selain X-Signature, header wajib yang harus dikirimkan pada saat request adalah:

Header Name	Description
X-TIMESTAMP	Timestamp saat request dibuat
X-SIGNATURE	Signature hasil generate dari Partner
X-PARTNER-ID	Client’s client_id (diberikan pada saat onboarding )
X-EXTERNAL-ID	ID external Partner (tidak boleh sama di hari yang sama)
CHANNEL-ID	Channel ID merchant

Komitmen Kami

Kami berkomitmen untuk memberikan kemudahan dalam proses integrasi, menghadirkan solusi yang fleksibel, efisien, dan mudah diimplementasikan. Melalui teknologi yang adaptif dan dukungan teknis yang handal, kami berfokus untuk memfasilitasi proses integrasi yang mulus sehingga Partner dapat berfokus pada pengembangan bisnis tanpa hambatan.

Berdasarkan komitmen kami untuk mempermudah proses integrasi, kami menyediakan postman collection dan example code

Postman Collection

Kami menyediakan Postman Collection untuk memudahkan proses integrasi dan pengujian API. Dengan menggunakan Postman Collectionini, Partner dapat langsung mengakses endpoint yang tersedia dan memahami alur request dan response secara lebih terstruktur. Untuk mempermudah, berikut adalah tabel variabel yang dapat Anda gunakan dalam Postman Collection ini, yang memungkinkan Anda untuk mengatur dan menyesuaikan konfigurasi secara dinamis.

Nama Variabel	Deskripsi	Contoh Value
snap_qr_mpm_local	url local (url local partner)	http://127.0.0.1:3000
snap_qr_mpm_devel	url dev (didapat saat onboarding)	https:/dev.sc.co.id/qris-mpm
snap_qr_mpm_staging	url stagging (didapat saat UAT stagging)	https:/stg.sc.co.id/qris-mpm
snap_qr_mpm_production	url prod (didapat setelah menyelesaikan snk prod)	https:/prd.sc.co.id/qris-mpm
mpm_partnerid	Kode unik tiap partner (didapat saat onboarding)	123791273921-1238122832
mpm_client_secret	Kode unik tiap partner (didapat saat onboarding)	12839012838123-1231237
mpm_channel_id	Kode Channel tiap partner	002
version	Version	v1.0

Untuk mempermudah integrasi, Partner dapat mengunduh Postman Collection yang sudah kami siapkan. Klik tombol di bawah ini untuk mengunduh:

Download Postman Collection

Example Code

Kami juga menyediakan Example Code untuk mempermudah integrasi melalui repositori GitHub, Partner bisa mendapatkan Example Code di GitHub kami: GitHub Repository