Brick API Documentation
Brick
Brick API

QR Code Dynamic

Server

Buat, uji, dan periksa Kode QRIS QR dinamis untuk pembayaran pelanggan. Kode QR dinamis dihasilkan per transaksi dan harus direkonsiliasi melalui callbacks atau penyelidikan status.


Generate Dynamic QR Code

POST
https://sandbox.onebrick.io
/v2/payments/gs/qris/dynamic
publicAccessToken (header)

Buat QRIS QR Code dinamis untuk jumlah pembayaran tertentu dan reference ID. Gunakan endpoint ini ketika setiap transaksi pelanggan memerlukan QR payload unik untuk pengumpulan pembayaran. Responsnya mencakup data QR yang dapat dirender dalam alur checkout Anda, sedangkan status pembayaran akhir harus dikonfirmasi melalui callbacks atau status dinamis QR endpoint.

Generate Dynamic QR Code › Request Body

referenceId
​string · required

Referensi unik Transaksi dari sisi klien (Panjang maksimum 25 karakter)

amount
​integer · int32 · required

Jumlah yang ingin ditransfer klien

validityPeriod
​string

Minimum 600 detik (10 menit), maksimum 86.400 detik (24 jam) dari waktu pembuatan. Jika tidak disetel, nilai defaultnya adalah 86.400 detik (24 jam)

Generate Dynamic QR Code › Responses

200

status
​integer
Default: 0
​object
​object
error
​

Status Dynamic QR Code

GET
https://sandbox.onebrick.io
/v2/payments/gs/qris/dynamic/{referenceId}
publicAccessToken (header)

Periksa status terbaru transaksi QRIS dinamis dengan reference ID. Gunakan endpoint ini ketika sistem Anda perlu mengonfirmasi apakah pembayaran QR masih diproses, sudah dibayar, kedaluwarsa, atau belum terselesaikan. Ini melengkapi callbacks dan berguna untuk pekerjaan rekonsiliasi, pemeriksaan dukungan pelanggan, dan layar konfirmasi pembayaran.

Status Dynamic QR Code › path Parameters

referenceId
​string · required

referenceId Transaksi yang unik

Status Dynamic QR Code › Responses

200

status
​integer
Default: 0
​object
​object
error
​

Pengujian QR Code di Sandbox

POST
https://sandbox.onebrick.io
/v2/payments/gs/qris/update-status-sandbox
publicAccessToken (header)

Simulasikan perubahan status pembayaran QRIS di lingkungan sandbox sehingga tim Anda dapat menguji penanganan dan rekonsiliasi callback sebelum produksi. Gunakan endpoint ini setelah membuat QR Code dinamis sandbox untuk memindahkan transaksi ke status pengujian yang diinginkan. Jangan gunakan untuk pembayaran produksi atau transaksi pelanggan langsung.

Pengujian QR Code di Sandbox › Request Body

referenceId
​string · required

referenceId Transaksi yang unik

status
​string · required

Status yang ingin dicapai (PAID/COMPLETED)

Default: PAID/COMPLETED

Pengujian QR Code di Sandbox › Responses

200

status
​integer
Default: 0
data
​string
​object
error
​