Unduh Postman

Product Overview

This document aims to explain the API specifications of the development of Dynamic QRIS - MPM with the scheme of merchants issuing QRIS, customers using tools to scan / scan merchant QRIS. Then from BRI sends a notification / callback in accordance with predetermined specifications.

Endpoint

Endpoint Description

This endpoint is used to get an access token that serves as authentication when you want to access other APIs. Pilot tests check that the get token is not hit every time you access the endpoint (integrator).

General Information

Header Structure

Request Structure

Response Structure

 {
  "grantType": "client_credentials"
 }

Normal Response:

 {
   "accessToken": "jwy7GgloLqfqbZ9OnxGxmYOuGu85",
   "tokenType": "BearerToken",
   "expiresIn": "899"
}

Error Response:

 {
  "responseCode": "4007301",
  "responseMessage": "Invalid Field Format"
}

List of Error/Response Code

Signature

Signature ensures that the transmitted data is authentic and cannot be refuted. The signature is generated by the service user and verified by the service receiver.

The signature is formed from the specified payload, by implementing the HMAC_SHA512 algorithm with clientSecret as the key.

Payload

Payload tergabung dari kata kerja, path, token, timestamp, dan body. Dengan format Symetric-Signature:

HMAC_SHA512 (clientSecret, stringToSign) dengan rumus stringToSign = HTTPMethod + ": "+ EndpointUrl + ": "+ AccessToken + ":" + Lowercase(HexEncode(SHA-256(minify(RequestBody))))+ ":" +TimeStamp

Example:

POST:/snap/v1.1/dummy:muhpwhwOkPRU9nNXYnyYHj8t54x3:8b4e9e83b5231cff4f84358ec8ca81951cfe9f999f635b1566452a501d5c23b2:2021-11- 29T09:22:18.172+07:00

The details of each element in the payload are described below:

Path

Value in path is URL after hostname and port without Query Parameter

Example:

https://sandbox.partner.api.bri.co.id/simulator/qr/qr-cpm-payment-url becomes /simulator/qr/qr-cpm-payment-ur

Verb

Method HTTP with capital letters.

Example: GET, POST, PUT, PATCH, and DELETE.

Token

The token used in the Authorisation header.

Example:  Bearer R04XSUbnm1GXNmDiXx9ysWMpFWBr

Timestamp

The time when sending the API request. The time format must follow ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSZ). Must be within zero UTC offset.

Example:

2021-11-02T13:14:15.678+07:00

Body

Body when submitting an API request. Lowercase(HexEncode(SHA-256(minify(RequestBody))))

Contoh: {"hello":"world"}

Result SHA256 : a47a5f14b3e78b5e3d3f81b1a1468499be964660f818c10adcac792c42709749

If there is no request body, for example using the GET method, just leave it blank.

Reference : https://developers.bri.co.id/en/snap-bi/apidocs-oauth-snap-bi

Endpoint Description

The Generate QR API is used to generate the Dynamic MPM QR

General Information                                                                            

Header Structure     

Request Structure                                                                                          

Request Structure in Object "amount"  

Response Structure             

Request & Response Payload Sample

Request:

{
  "partnerReferenceNo": "1234567890133",
   "amount": {
     "value": "123456.00",
     "currency": "IDR"
   },
   "merchantId": "00007100010926",
   "terminalId": "213141251124"
}

Normal Response:

{
  "responseCode": "2004700",
  "responseMessage": "Successful",
  "partnerReferenceNo": "1234567890133",
  "qrContent": "0002XXXXXXXXX",
  "referenceNo": "409676201434"
}

Endpoint Description

Endpoint to make a Dynamic MPM QR payment inquiry.

General Information

Header Structure

Request Structure

Request Structure in Object "additionalInfo"

Response Structure

Response Structure in Object "amount"

Response Structure in Object "additionalInfo"

Request & Response Payload Sample Request:

{
  "originalReferenceNo":"290005165369",
  "serviceCode":"17",
  "additionalInfo":{
    "terminalId": "10049258"
  }
}

Normal Response:

{
    "responseCode": "2005100",
    "responseMessage": "Successful",
    "originalReferenceNo": "290005165369",
    "serviceCode": "17",
    "latestTransactionStatus": "00",
    "transactionStatusDesc": "Successfully",
    "amount": {
        "value": "2000.00",
        "currency": "IDR"
    },
    "terminalId": "10049258",
    "additionalInfo": {
        "customerName": "I GEDE TONI DHARMAWAN",
        "customerNumber": "9360015723456789",
        "invoiceNumber": "10009121031000912103",
        "issuerName": "Finnet 2",
        "issuerRrn": "110002756582",
        "mpan": "9360000201102921379"
    }
}

List of Error/Response Code

Endpoint Description

Endpoint for refund QRIS MPM Dynamic

General Information

Header Structure

Request Structure

Request Structure in Object "refundAmount"

Request Structure in Object "additionalInfo"

Response Structure

Response Structure in Object "refundAmount"

Request & Response Payload Sample Request:

{
    "merchantId": "000001989110137",
    "originalPartnerReferenceNo": "1982047513684",
    "originalReferenceNo": "",
    "partnerRefundNo": "12345678901234567",
    "refundAmount": {
        "value": "100.00",
        "currency": "IDR"
    },
    "additionalInfo": {
        "invoiceNumber": "19352405261935240526",
        "terminalId": "15012304"
    }
}

Normal Response:

{
    "responseCode": "2007800",
    "responseMessage": "Successful",
    "originalPartnerReferenceNo": "1982047513684",
    "originalReferenceNo": "574072067022",
    "refundNo": "",
    "partnerRefundNo": "12345678901234567",
    "refundAmount": {
        "value": "100.00",
        "currency": "IDR"
    },
    "refundTime": "2026-05-18T11:26:55+07:00"
}

List of Error/Response Code