Download Postman

Product Overview

QRIS Static API function is to generate QR Code that can be used by end customer indefinitely, therefore BRIAPI partner can just print out the QR Code once and use the Code to do every transactions. QRIS Static is very suitable for businesses that like to do cashless transactions without the hassle of providing device to generate QR Code every time there's a transaction. 

Endpoint

BRIAPI uses the OAuth 2 Authorization Framework to grant a third-party access to user accounts on an HTTP service. Before requesting our API, you have to retrieve a token by calling the Get Token endpoint.

To ensure API request safety, BRIAPI generates signatures to assure that the request or response cannot be intercepted and imitated by unauthorized users. This signature is generated using the SHA256-HMAC algorithm.

Endpoint Description

API Generate URL used to generate the login URL to the QRIS Static system.

General Information

Header Structure

Request Structure

Response Structure

Response Structure in Object "additionalInfo"

Request & Response Payload Sample

Request :

{
  "redirectUri": "https://thirdparty.co.id",
  "state":"121"
}

Normal Response :

{
    "responseCode":"2004700",
    "responseMessage":"Successful",
    "url": "https://sandbox.partner.api.bri.co.id/v1.0/qr-auth/login/a19038d2f97dcca85d34f5eadaa99aaf",
    "additionalInfo":
   
    {
            "trxType": "generate_url"
    }
}

Error Response :

{
    "responseCode": "5004700",
    "responseMessage": "General Error"
}

List of Error/Response Code

Any error response not listed in the BRIAPI response list is considered pending and requires further investigation.

Endpoint Description

API Get Merchant Key used to get the merchant key from the login code.

General Information

Header Structure

Request Structure

Response Structure

Response Structure in Object "additionalInfo"

Request & Response Payload Sample

Request :

   {
      "code":"123456789012345678901234567890AB" 
    }
   

Normal Response :

 {
    "responseCode": "2004700",
    "responseMessage": "success",
    "merchantId": "051035c359b7a5d2858568894065d720",
    "createdDate": "2021-12-15 00:00:00",
    "token": "2824dd9df782c7ec86773f128263a467",
    "tokenExpired": "2021-12-31 01:10:23",
    "state": null,
    "additionalInfo": {
        "trxType": "get_mkey_by_token",
        "mpan": "9360000200100971691",
    }
}   

Error Response :

{
    "responseCode": "4044708",
    "responseMessage": "Invalid Merchant"
}

List of Error/Response Code

Any error response not listed in the BRIAPI response list is considered pending and requires further investigation.

Endpoint Description

API Get QR By Merchant Key used to generate static QR based on merchant key.

General Information

Header Structure

Request Structure

Response Structure

Response Structure in Object "additionalInfo"

Request & Response Payload Sample

Request :

     {
   "merchantId": "223456789012345678901234567890AB" 
    }
   

Normal Response :

        {
            "responseCode": "2004700",
           "responseMessage": "Request has been processed successfully",
           "referenceNo": "2020102977770000000009",
           "partnerReferenceNo": "2020102900000000000001",
           "qrContent": "https://www.investopedia.com/terms/q/quick-response-qr-code.asp",
           "qrImage": "TWFuIGlzIGRpc3Rpbmd1aXNoZWQsIG5vdCBvbmx5IGJ5IGhpcyByZWFzb24sIGJ1dCAuLi4=",
           "merchantName": "Baso Malang",
           "additionalInfo":
           {
             "trxType": "GetQRByMkey",
             "merchantCity": "BANYUWANGI"
            }
        }   
        

Error Response :

        {
            "responseCode": "4044708",
            "responseMessage": "Invalid Merchant"
        }
        

List of Error/Response Code

Any error response not listed in the BRIAPI response list is considered pending and requires further investigation.

Endpoint Description

API List Transaction By Last Five Merchant Key used to get the last five QRIS Static transaction data.

General Information

Header Structure

Request Structure

Response Structure

Response Structure in Array"transactionList"

Response Structure Object"additionalInfo"

Request & Response Payload Sample

Request :

     {  
      "merchantId": "051035c359b7a5d2858568894065d720" 
      }

Normal Response :

{
   "responseCode": "2004700",
   "responseMessage": "Request has been processed successfully",
   "transactionList":
  }
 { 
    {
       "trxDate": "2021-12-22 13:53:37",
       "referenceNum": null,
       "id": 1380149,
       "trxAmount": "20000",
       "issName": null,
       "invoiceNumber": "0",
       "cpan": null
    }

    {

       "trxDate": "2021-12-22 13:49:47",
       "referenceNum": null,
       "id": 1380148,
       "trxAmount": "12000",
       "issName": null,
       "invoiceNumber": "0",
       "cpan": null
    },

    {

      "trxDate": "2021-12-22 13:48:39",
      "referenceNum": null,
      "id": 1380147,
      "trxAmount": "12000",
      "issName": null,
      "invoiceNumber": "0",
      "cpan": null
    },

    {

      "trxDate": "2021-12-22 13:46:06",
      "referenceNum": null,
      "id": 1380146,
      "trxAmount": "10000",
      "issName": null,
      "invoiceNumber": "0",
      "cpan": null
    },

    {

      "trxDate": "2021-12-21 14:43:00",
      "referenceNum": null,
      "id": 1380138,
      "trxAmount": "125000",
      "issName": null,
      "invoiceNumber": "0",
      "cpan": null
  }
],

"page":

{

"totalRecord": 5, 
"totalPage": 1, 
"recordPerPage": "10", 
"currentPage": "1", 
"startRecord": 1

}

"additionalInfo":

 {
      "trxType": "ListTrxLastFive_mkey"
 } 
}   

Error Response :

{
    "responseCode": "4044701",
    "responseMessage": "Transaction Not Found"
}

List of Error/Response Code

Any error response not listed in the BRIAPI response list is considered pending and requires further investigation.

Endpoint Description

API List Transaction By Merchant Key used to get QRIS Static transaction data.

General Information

Header Structure

Request Structure

Response Structure

Response Structure in Array"transactionList"

Response Structure in Object"page"

Response Structure in Object"additionalInfo"

Request & Response Payload Sample

Request :

       { 
          "merchantId":"423456789012345678901234567890AF",  
          "page": "1",  
          "limit":"10",  
          "dateFrom":"2020-02-06",   
          "dateUntil":"2020-02-07" 
       }

Normal Response :

{
  
  "responseCode": "2004700",
    "responseMessage": "Request has been processed successfully",
    "transactionList":
  
[
 
{
  
 "trxDate": "2021-12-22 13:53:37",
   "referenceNum": null,
   "id": 1380149,
   "trxAmount": "20000",
   "issName": null,
   "invoiceNumber": "0",
   "cpan": null
         
},
  
{
  
"trxDate": "2021-12-22 13:49:47",
"referenceNum": null,
"id": 1380148,
"trxAmount": "12000",
"issName": null,
"invoiceNumber": "0",
"cpan": null
         
},
          
{
               
"trxDate": "2021-12-22 13:48:39",
"referenceNum": null,
"id": 1380147,
"trxAmount": "12000",
"issName": null,
"invoiceNumber": null,
"cpan": null
           
},
           
{
              
"trxDate": "2021-12-22 13:46:06",
"referenceNum": null,
"id": 1380146,
"trxAmount": "10000",
"issName": null,
"invoiceNumber": null,
"cpan": null
           
},
           
{
"trxDate": "2021-12-21 14:43:00",
"trxDate": "2021-12-21 14:43:00",
"id": 1380138,
"trxAmount": "125000",
"issName": null,
"invoiceNumber": "0",
"cpan": null
            
}
      
],
       
"page":
          
{
              
"totalRecord": 5,
"totalPage": 1,
"recordPerPage": "10",
"currentPage": "1",
"startRecord": 1
          
},
          
"additionalInfo":
          
{
          
"trxType": "ListTrxLastFive_mkey"
         
}     

}   

Error Response :

{
   "responseCode": "4044701",
    "responseMessage": "Transaction Not Found"
}

List of Error/Response Code

Any error response not listed in the BRIAPI response list is considered pending and requires further investigation.