QRIS

QRIS (Quick Response Code Indonesian Standard) is a QR code standard developed by Bank Indonesia and Indonesian Payment System Association (ASPI) for cashless payments in Indonesia.

Overview Steps

Overview of integration process with QRIS

1. Generate QRIS

2. Query QRIS

3. Refund QRIS

4. Decode QRIS

5. Payment QRIS

---

1. Generate QRIS

After customer creates an order and choose QRIS as the payment method, merchant will hit this API to generate QRIS that will be shown to the customer. To generate QRIS, you need to hit this API through your Backend:

API Endpoint

Environment	Endpoint
HTTP Method	POST
API Sandbox	https://api-sandbox.doku.com
API Production	https://api.doku.com
Path	/snap-adapter/b2b/v1.0/qr/qr-mpm-generate

Here is the sample request header, request body and response body for generate QRIS:

POST Generate QRIS

POSThttps://api-sandbox.doku.com/snap-adapter/b2b/v1.0/qr/qr-mpm-generate

Header parameters

Body

application/json

partnerReferenceNo*string

Transaction ID from partners

Example: "a98757c8dbc6434ab5dd4c55d9092d9a"

amount*object

Detail Amount

feeAmount*object

Detail Fee Amount

merchantId*string

Credential mall ID from DOKU

Example: 2115

terminalId*string

Terminal Identification alphanumeric

Example: "k45"

validityPeriodstring

Expired Time QRIS using ISO 8601 Format, if not sent will use Default value 30 days

Example: "2023-11-08T17:38:42+07:00"

additionalInfo*object

Additional Information

Response

200

OK

Body

application/json

responseCodestring

Example: "2004700"

responseMessagestring

Example: "Request has been processed successfully"

referenceNostring

Example: "a98757c8dbc6434ab5dd4c55d9092d9a"

partnerReferenceNostring

Example: "a98757c8dbc6434ab5dd4c55d9092d9a"

qrContentstring

Example: "00020101021226530012COM.DOKU.WWW0118936008990000002997020429970303UMI51440014ID.CO.QRIS.WWW0215ID20200622029970303UMI52045411530336054071200.255502025606500.525802ID5911Green Pages6007Jakarta61051312062430703K455032a98757c8dbc6434ab5dd4c55d9092d9a6304F6EA"

terminalIdstring

Example: "K45"

additionalInfoobject

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api-sandbox.doku.com/snap-adapter/b2b/v1.0/qr/qr-mpm-generate', {
    method: 'POST',
    headers: {
      "X-PARTNER-ID": "text",
      "X-EXTERNAL-ID": "text",
      "X-SIGNATURE": "text",
      "Authorization": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "partnerReferenceNo": "a98757c8dbc6434ab5dd4c55d9092d9a",
      "amount": {
        "value": "1000.00",
        "currency": "IDR"
      },
      "feeAmount": {
        "value": "500.00",
        "currency": "IDR"
      },
      "merchantId": 2115,
      "terminalId": "k45",
      "additionalInfo": {
        "postalCode": 13120,
        "feeType": 2
      }
    }),
});
const data = await response.json();

Response

200

{
  "responseCode": "2004700",
  "responseMessage": "Request has been processed successfully",
  "referenceNo": "a98757c8dbc6434ab5dd4c55d9092d9a",
  "partnerReferenceNo": "a98757c8dbc6434ab5dd4c55d9092d9a",
  "qrContent": "00020101021226530012COM.DOKU.WWW0118936008990000002997020429970303UMI51440014ID.CO.QRIS.WWW0215ID20200622029970303UMI52045411530336054071200.255502025606500.525802ID5911Green Pages6007Jakarta61051312062430703K455032a98757c8dbc6434ab5dd4c55d9092d9a6304F6EA",
  "terminalId": "K45",
  "additionalInfo": {
    "validityPeriod": "2023-11-08T17:38:42+07:00"
  }
}

2. Query QRIS

To query QRIS, you need to hit this API through your Backend:

API Endpoint

Environment	Endpoint
HTTP Method	POST
API Sandbox	https://api-sandbox.doku.com
API Production	https://api.doku.com
Path	/snap-adapter/b2b/v1.0/qr/qr-mpm-query

Here is the sample request header, request body and response body for query QRIS:

POST Query QRIS

POSThttps://api-sandbox.doku.com/snap-adapter/b2b/v1.0/qr/qr-mpm-query

Header parameters

Body

application/json

originalReferenceNo*string

Transaction ID from DOKU when Generate QRIS

Example: "7d054649f9ba4c19ae5f95950c99be4d"

originalPartnerReferenceNo*string

Transaction ID from partners when Generate QRIS

Example: "7d054649f9ba4c19ae5f95950c99be4d"

serviceCode*string

Unique service API “51”

Example: 51

merchantId*string

Merchant ID registered in DOKU

Example: 2997

Response

200

OK

Body

application/json

responseCodestring

Example: "2005100"

responseMessagestring

Example: "Request has been processed successfully"

originalReferenceNostring

Example: "7d054649f9ba4c19ae5f95950c99be4d"

originalPartnerReferenceNostring

Example: "7d054649f9ba4c19ae5f95950c99be4d"

serviceCodestring

Example: "51"

latestTransactionStatusstring

Example: "00"

transactionStatusDescstring

Example: "Success"

paidTimestring

Example: "2023-08-18T23:12:21+07:00"

amountobject

feeAmountobject

additionalInfoobject

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api-sandbox.doku.com/snap-adapter/b2b/v1.0/qr/qr-mpm-query', {
    method: 'POST',
    headers: {
      "X-PARTNER-ID": "text",
      "X-TIMESTAMP": "text",
      "X-EXTERNAL-ID": "text",
      "X-SIGNATURE": "text",
      "Authorization": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "originalReferenceNo": "7d054649f9ba4c19ae5f95950c99be4d",
      "originalPartnerReferenceNo": "7d054649f9ba4c19ae5f95950c99be4d",
      "serviceCode": 51,
      "merchantId": 2997
    }),
});
const data = await response.json();

Response

200

{
  "responseCode": "2005100",
  "responseMessage": "Request has been processed successfully",
  "originalReferenceNo": "7d054649f9ba4c19ae5f95950c99be4d",
  "originalPartnerReferenceNo": "7d054649f9ba4c19ae5f95950c99be4d",
  "serviceCode": "51",
  "latestTransactionStatus": "00",
  "transactionStatusDesc": "Success",
  "paidTime": "2023-08-18T23:12:21+07:00",
  "amount": {
    "value": 1200,
    "currency": "IDR"
  },
  "feeAmount": {
    "value": 500,
    "currency": "IDR"
  },
  "additionalInfo": {
    "approvalCode": "328591"
  }
}

3. Refund QRIS

This endpoint is used to create refund request for previous successful payment, merchant can request a transaction refund to DOKU. To refund, you need to hit this API through your Backend:

API Endpoint

Environment	Endpoint
HTTP Method	POST
API Sandbox	https://api-sandbox.doku.com
API Production	https://api.doku.com
Path	/snap-adapter/b2b/v1.0/qr/qr-mpm-refund

Here is the sample request header, request body and response body for refund QRIS:

POST Refund QRIS

POSThttps://api-sandbox.doku.com/snap-adapter/b2b/v1.0/qr/qr-mpm-refund

Header parameters

Body

application/json

merchantId*string

Credential mall ID from DOKU

Example: 2115

originalPartnerReferenceNo*string

Transaction ID from DOKU when Generate QRIS

Example: "originalPartnerReferenceNo"

originalReferenceNostring

Transaction ID from DOKU when Generate QRIS

Example: "7d054649f9ba4c19ae5f95950c99be4d"

partnerRefundNo*string

Example: "partnerRefundNo"

refundAmount*object

reason*string

Example: "refund reason"

additionalInfo*object

Response

200

OK

Body

application/json

responseCodestring

Example: "2007800"

responseMessagestring

Example: "Request has been processed successfully"

originalReferenceNostring

Example: "82367e5283b94a47a920859bcb4af4d6"

originalPartnerReferenceNostring

Example: "82367e5283b94a47a920859bcb4af4d6"

refundNostring

Example: "QRISR0001"

partnerRefundNostring

Example: "QRISR0001"

refundAmountobject

refundTimestring

Example: "2022-11-11T10:51:48+07:00"

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api-sandbox.doku.com/snap-adapter/b2b/v1.0/qr/qr-mpm-refund', {
    method: 'POST',
    headers: {
      "X-PARTNER-ID": "text",
      "X-TIMESTAMP": "text",
      "X-EXTERNAL-ID": "text",
      "X-SIGNATURE": "text",
      "Authorization": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "originalPartnerReferenceNo": "originalPartnerReferenceNo",
      "partnerRefundNo": "partnerRefundNo",
      "refundAmount": {
        "value": 1200,
        "currency": "IDR"
      },
      "reason": "refund reason",
      "additionalInfo": {
        "approvalCode": "328591"
      },
      "merchantId": 2115
    }),
});
const data = await response.json();

Response

200

{
  "responseCode": "2007800",
  "responseMessage": "Request has been processed successfully",
  "originalReferenceNo": "82367e5283b94a47a920859bcb4af4d6",
  "originalPartnerReferenceNo": "82367e5283b94a47a920859bcb4af4d6",
  "refundNo": "QRISR0001",
  "partnerRefundNo": "QRISR0001",
  "refundAmount": {
    "value": 1200,
    "currency": "IDR"
  },
  "refundTime": "2022-11-11T10:51:48+07:00"
}

4. Decode QRIS

To decode QRIS, you need to hit this API through your Backend:

API Endpoint

Environment	Endpoint
HTTP Method	POST
API Sandbox	https://api-sandbox.doku.com
API Production	https://api.doku.com
Path	/snap-adapter/b2b/v1.0/qr/qr-mpm-decode

Here is the sample request header, request body and response body for decode QRIS:

POST Decode QRIS

POSThttps://api-sandbox.doku.com/snap-adapter/b2b/v1.0/qr/qr-mpm-decode

Header parameters

Body

application/json

partnerReferenceNo*string

Transaction ID from partners

Example: "75a98757c8dbc6434ab5dd4c55d9092d9a"

qrContent*string

QRIS content. QRIS generated by DOKU or other PJSP. Can be dynamic or static QRIS.

Example: "00020101021226530012COM.DOKU.WWW0118936008990000002997020429970303UMI51440014ID.CO.QRIS.WWW0215ID20200622029970303UMI52045411530336054071200.255502025606500.525802ID5911Green Pages6007Jakarta61051312062430703K455032a98757c8dbc6434ab5dd4c55d9092d9a6304F6EA"

scanTime*string

The time when the QRIS scanned by the User, ISO 8601 Format

Example: "2023-11-08T17:38:42+07:00"

Response

200

OK

Body

application/json

responseCodestring

Example: "2004800"

responseMessagestring

Example: "Request has been processed successfullys"

referenceNostring

Example: "25571a62302c43a881c684cccc7ecbae"

partnerReferenceNostring

Example: "25571a62302c43a881c684cccc7ecbae"

merchantNamestring

Example: "Green Pages"

transactionAmountobject

feeAmountobject

additionalInfoobject

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api-sandbox.doku.com/snap-adapter/b2b/v1.0/qr/qr-mpm-decode', {
    method: 'POST',
    headers: {
      "X-PARTNER-ID": "text",
      "X-TIMESTAMP": "text",
      "X-EXTERNAL-ID": "text",
      "X-SIGNATURE": "text",
      "Authorization": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "partnerReferenceNo": "75a98757c8dbc6434ab5dd4c55d9092d9a",
      "qrContent": "00020101021226530012COM.DOKU.WWW0118936008990000002997020429970303UMI51440014ID.CO.QRIS.WWW0215ID20200622029970303UMI52045411530336054071200.255502025606500.525802ID5911Green Pages6007Jakarta61051312062430703K455032a98757c8dbc6434ab5dd4c55d9092d9a6304F6EA",
      "scanTime": "2023-11-08T17:38:42+07:00"
    }),
});
const data = await response.json();

Response

200

{
  "responseCode": "2004800",
  "responseMessage": "Request has been processed successfullys",
  "referenceNo": "25571a62302c43a881c684cccc7ecbae",
  "partnerReferenceNo": "25571a62302c43a881c684cccc7ecbae",
  "merchantName": "Green Pages",
  "transactionAmount": {
    "value": 1200,
    "currency": "IDR"
  },
  "feeAmount": {
    "value": 500,
    "currency": "IDR"
  },
  "additionalInfo": {
    "pointOfInitiationMethod": 12,
    "pointOfInitiationMethodDescription": "DYNAMIC",
    "feeType": 2,
    "feeTypeDescription": "FIX_TIPS"
  }
}

5. Payment QRIS

You need to hit this API through your Backend:

API Endpoint

Environment	Endpoint
HTTP Method	POST
API Sandbox	https://api-sandbox.doku.com
API Production	https://api.doku.com
Path	/snap-adapter/b2b2c/v1.0/qr/qr-mpm-payment

Here is the sample request header, request body and response body for payment QRIS:

POST Payment QRIS

POSThttps://api-sandbox.doku.com/snap-adapter/b2b2c/v1.0/qr/qr-mpm-payment

Header parameters

Body

application/json

partnerReferenceNo*string

Example: "91cbe52caf27471482d3430c37d174fc"

amount*object

feeAmount*object

additionalInfoobject

Response

200

OK

Body

application/json

responseCodestring

Example: "2005000"

responseMessagestring

Example: "Request has been processed successfully"

referenceNostring

Example: "91cbe52caf27471482d3430c37d174fc"

partnerReferenceNostring

Example: "91cbe52caf27471482d3430c37d174fc"

amountobject

feeAmountobject

additionalInfoobject

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api-sandbox.doku.com/snap-adapter/b2b2c/v1.0/qr/qr-mpm-payment', {
    method: 'POST',
    headers: {
      "X-PARTNER-ID": "text",
      "X-TIMESTAMP": "text",
      "X-EXTERNAL-ID": "text",
      "X-SIGNATURE": "text",
      "Authorization": "text",
      "Authorization-Customer": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "partnerReferenceNo": "91cbe52caf27471482d3430c37d174fc",
      "amount": {
        "value": 1200,
        "currency": "IDR"
      },
      "feeAmount": {
        "value": 500,
        "currency": "IDR"
      }
    }),
});
const data = await response.json();

Response

200

{
  "responseCode": "2005000",
  "responseMessage": "Request has been processed successfully",
  "referenceNo": "91cbe52caf27471482d3430c37d174fc",
  "partnerReferenceNo": "91cbe52caf27471482d3430c37d174fc",
  "amount": {
    "value": 1200,
    "currency": "IDR"
  },
  "feeAmount": {
    "value": 500,
    "currency": "IDR"
  },
  "additionalInfo": {
    "approvalCode": 328580
  }
}