Copy page

BrickCollect - Acceptance

Static QRIS

Merchant creation

Clients need to create main merchant first to use QRIS products, You can get the step-by-step process here to generate the merchant, Once the merchant is verified then please follow the below process.

1. Generating a Static QR code

Generation of Static QRIS is a one-time process,

ReadMe image block:

Code
{
  "images": [
    {
      "image": [
        "https://files.readme.io/67e074b-Screenshot_2024-03-13_at_11.49.47_AM.png",
        "",
        ""
      ],
      "align": "center",
      "border": true
    }
  ]
}

Clients can download the static QRIS from the merchant list page by clicking three "vertical dots" under action section. Static QRIS can be only downloaded once the merchant is verified.

---

2. Callback notification

Brick notifies you when the user has already made the payment via callbacks (you will be able to set up the Virtual account callback in the Brick Dashboard )

The callback will be received once payment is made by the end user.

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"
  }
}

📘 Setting up your QRIS callback URL

For now setting up callback QRIS need to be done manually. You can contact Brick team to setup your QRIS callback URL.

3. Status check for QR Codes

This APIs will help clients to initialize the status update from their side, They have to pass on the transactions referenceId and gets the update.

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

You will get the response like below

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
}

QRIS status available are processing, paid, expired, and cancelled.

---

4. Static QRIS Get Merchant Details

These APIs will help clients get the bulk merchant details list from their side. They have to pass the right token, and they will get the details of the list.

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

You will get the response like below

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. Static QRIS Get Merchant List

These APIs will help clients get the bulk merchant list from their side. They have to pass the right token, and they will get the list.

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

You will get the response like below

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