Copy page

QR Code Statis

QR Code Statis adalah aliran pembayaran QRIS Brick untuk penerimaan pembayaran QR pedagang yang dapat digunakan kembali. Gunakan QR Code Statis ketika kode QR yang sama harus menerima beberapa pembayaran pelanggan dan pelanggan dapat memasukkan sendiri jumlah pembayarannya.

Sebelum menggunakan QR Code Statis, buat dan verifikasi pedagang QR Code. Lihat Registering for QR Code, lalu ikuti proses di bawah ini.

1. Menghasilkan QR Code Statis

Menghasilkan QR Code Statis adalah proses satu kali.

Anda dapat mendownload Static QR Code dari halaman daftar merchant dengan membuka menu tindakan untuk merchant. QR Code statis dapat diunduh setelah pedagang terverifikasi.

---

2. Pemberitahuan Panggilan Balik

Brick memberi tahu Anda ketika pengguna telah melakukan pembayaran melalui panggilan balik. Penyiapan panggilan balik QR Code ditangani dengan tim Brick atau di Dasbor Brick, bergantung pada penyiapan akun Anda.

Panggilan balik akan diterima setelah pembayaran dilakukan oleh pengguna akhir.

Code
{
  "data": {
    "id": "QR_XXXX",
    "referenceId": "XXXX",
    "amount": 32000,
    "status": "PAID",
    "createdAt": "2024-03-13T14:12:25.000+07:00",
    "paidAt": "2024-03-13T14:12:26.212+07:00",
    "qrisType": "STATIC",
    "merchant": "merchant_name",
    "merchantNmid": "merchant_Nmid"
  }
}

📘 Menyiapkan URL panggilan balik QR Code Anda

Untuk saat ini pengaturan callback QR Code perlu dilakukan secara manual. Anda dapat menghubungi tim Brick untuk menyiapkan URL panggilan balik QR Code Anda.

3. Pemeriksaan Status Kode QR

Gunakan titik akhir status untuk mengambil status Statis QR Code terbaru dengan meneruskan transaksi referenceId.

Code
 curl --location 'https://sandbox.onebrick.io/stg/v2/payments/gs/qris/static/{{referenceId}}' \
--header 'publicAccessToken: Bearer {{publicAccessToken}}'

Anda akan mendapatkan respon seperti di bawah ini

Code
{
    "status": 200,
    "data": {
        "referenceId": "XXXX",
        "id": "QR_XXXX",
        "amount": 32000,
        "status": "completed",
        "qrData": "",
        "paidAt": "2024-03-05T01:51:01.000+07:00",
        "type": "STATIC",
        "merchant": "merchant_name",
        "merchantNmid": "merchant_Nmid"
    },
    "metaData": {
        "source": "API",
        "entity": "Payment"
    },
    "error": null
}

Status QR Code yang tersedia adalah diproses, dibayar, kadaluwarsa, dan dibatalkan.

---

4. QR Code Statis Dapatkan Detail Merchant

Gunakan API ini untuk mengambil detail pedagang dengan token yang diperlukan.

Code
curl --request GET \
     --url https://sandbox.onebrick.io/v2/payments/gs/qris/merchant/id \
     --header 'accept: application/json' \
     --header 'publicAccessToken: Bearer {{publicAccessToken}}'

Anda akan mendapatkan respon seperti di bawah ini

Code
{
  "status": 200,
  "data": {
    "id": 25,
    "name": "Brick Qris Merchant",
    "email": "merchant@mail.com",
    "ownerName": "Brick",
    "address": "JL Tulodong",
    "nmid": "ID2020088800402",
    "qrisImageUrl": "{{url_qr_code_merchant}}",
    "status": "VERIFIED"
  },
  "metaData": {
    "source": "API",
    "entity": "Payment"
  },
  "error": null
}

5. QR Code Statis Dapatkan Daftar Merchant

Gunakan API ini untuk mengambil daftar pedagang dengan token yang diperlukan.

Code
curl --request GET \
     --url https://sandbox.onebrick.io/v2/payments/gs/qris/merchant/bulk \
     --header 'accept: application/json' \
     --header 'publicAccessToken: Bearer {{publicAccessToken}}'

Anda akan mendapatkan respon seperti di bawah ini

Code
{
    "status": 200,
    "data": [
        {
            "id": 25,
            "name": "Brick Qris Merchant",
            "email": "merchant@mail.com",
            "ownerName": "Brick",
            "address": "JL Tulodong",
            "nmid": "ID2020088800402",
            "qrisImageUrl": "{{url_qr_code_merchant}}",
            "status": "VERIFIED"
        }
    ],
    "metaData": {
        "source": "API",
        "entity": "Payment"
    },
    "error": null