Generate QRIS

Path	/ordersnap/api/v1.0/qr/qr-mpm-generate
HTTP Method	POST
Version	v1.0
Service Code	47

Request Header

Field Name	Field Type	Mandatory	Field Description
Content-type	String	M	Media type of the resource, i.e. application/json
X-TIMESTAMP	String	M	Client’s current local time in ISO-8601 format
X-SIGNATURE	String	M	Created using symmetric signature HMAC_SHA512 algorithm. Read here
Authorization	String	M	Represents access_token of a request; string starts with keyword “Bearer ” followed by access_token. Can get this token from Access Token B2B response. Read here
X-PARTNER-ID	String	M	Unique identifier for caller (client_id)
X-EXTERNAL-ID	String	M	Merchant’s unique ID per transaction request
CHANNEL-ID	String	M	PJP’s channel id.

Example Header

Field Name	Value
Content-type	application/json
X-TIMESTAMP	2024-03-19T14:30:00+07:00
X-SIGNATURE	da1fa417c72d6b91c257e01e54fac824
Authorization	Bearer gp9HjjEj813Y9JGoqwOeOPWbnt4CupvIJbU1Mmu4a11MNDZ7Sg5u9a
X-PARTNER-ID	7fb118fb-2738-4886-9817-8a2c4de43001
X-EXTERNAL-ID	41807553358950093184162180797837
CHANNEL-ID	95221

Request Body

Field Name	Field Type	Mandatory	Field Description
partnerReferenceNo	String(36)	M	Alphanumeric string. Preferably UUID. Reference number that should be unique across 3 months. This value should be filled with the same value as X-EXTERNAL-ID
amount	Object	M	Amount object
amount.value	String(16,2)	M	Transaction amount
amount.currency	String(3)	M	Transaction currency
merchantId	String(64)	O	Merchant identifier that is unique per each merchant
subMerchantId	String(32)	O	Sub merchant ID
storeId	String(64)	O	Store ID
terminalId	String(16)	O	Merchant terminal id
validityPeriod	String(25)	M	The time when the QRIS will automatically expire. The time when the payment will be automatically expired. The format is defined by ISO 8601.
additionalInfo	Object	M	Additional information
additionalInfo.acquirer	Integer	M	ID Acquirer
additionalInfo.Items	Array of Object	M	Items Object
additionalInfo.Items.id	String	M	ID Items
additionalInfo.Items.price	String	M	Price Object
additionalInfo.Items.price.value	String	M	Price value
additionalInfo.Items.price.currency	String	M	Transaction currency
additionalInfo.Items.quantity	String	M	Quantity of items
additionalInfo.Items.name	String	M	Items Name
additionalInfo.Items.brand	String	O	Brand Items
additionalInfo.Items.category	String	O	Category items
additionalInfo.Items.merchantName	String	O	Merchant Name
additionalInfo.customerDetails	Object	M	Object Costumer Details
additionalInfo.customerDetails.email	String	M	Email Customer
additionalInfo.customerDetails.firstName	String	M	First name customer
additionalInfo.customerDetails.lastName	String	M	Last name customer
additionalInfo.customerDetails.phone	String	M	Phone number customer
additionalInfo.metadata	Object	O	Object containing the metadata parameters.
additionalInfo.countryCode	String	O	Code Country
additionalInfo.locale	String	O	Specifies the language and regional settings for the checkout page

{
  "partnerReferenceNo": "240847003240847003",
  "amount": {
    "value": "1000.00",
    "currency": "IDR"
  },
  "merchantId": "00007100010926",
  "terminalId": "213141251124",
  "validityPeriod": "2024-08-23T07:44:11+07:00",
  "additionalInfo": {
    "acquirer": 36,
    "items": [
      {
        "id": "susumaniskaleng",
        "price": {
          "value": "1000",
          "currency": "IDR"
        },
        "quantity": "1",
        "name": "HOLYCOW 1KG T-bone",
        "brand": "Makan makan 1OMS ",
        "category": "Food",
        "merchantName": ""
      }
    ],
    "customerDetails": {
      "email": "[email protected]",
      "firstName": "Budi",
      "lastName": "Utomo",
      "phone": "081223323423"
    },
    "metadata": {
    },
    "countryCode": "ID",
    "locale": "id_ID"
  }
}

Response Body

Field Name	Field Type	Mandatory	Field Description
additionalInfo	Object	M	Additional Information
additionalInfo.acquirer	Integer	M	ID Acquirer
additionalInfo.amount	Object	M	Amount Object
additionalInfo.amount.currency	String	M	Amount currency
additionalInfo.amount.value	String	M	Amount value
additionalInfo.createdAt	Object	M	Object transaction created
additionalInfo.createdAt.dateTime	String	M	Datetime transaction created
merchantName	String	O	Merchant name
partnerReferenceNo	String (36)	O	partnerReferenceNo from the request body
qrContent	String(512)	C	QR String MPM. If qrContent is null, then qrUrl or qrImage must be filled.
qrImage	String	O	base64 from image QRIS. Max length is unlimited.
qrUrl	String	O	QR URL for download QR Image
referenceNo	String (64)	O	Transaction identifier on service provider system.
responseCode	String (7)	M	Response Code (HTTP status code + service code + case code)
responseMessage	String (150)	M	Description of charge result response.
storeId	String	O	unique shop id on the merchant side.
terminalId	String	O	Merchant terminal id

{
    "additionalInfo": {
        "acquirer": 36,
        "amount": {
            "currency": "IDR",
            "value": "1000.00"
        },
        "createdAt": {
            "dateTime": "2024-08-23T07:44:11+07:00",
            "offset": {
                "totalSeconds": 0
            },
            "zone": {
                "totalSeconds": 0
            }
        },
        "merchantCrossRefId": "",
        "recurring": false,
        "transactionType": "MERCHANT_TRANSACTION"
    },
    "merchantName": "",
    "partnerReferenceNo": "240847003240847095",
    "qrContent": "00020101021226580011id.qoin.www01189360084202020002110210Q2023002110303UME51370014ID.CO.QRIS.WWW0215ID0000202300211520458125303360540410005802ID5914Qoin Hub Store6007Jakarta61051321062200112QD00000005810700630459B2",
    "qrImage": "",
    "qrUrl": "",
    "referenceNo": "T24080680391",
    "responseCode": "2004700",
    "responseMessage": "Successful",
    "storeId": "",
    "terminalId": ""
}

List of Response Code

Response Code	HTTP Status	Description
2004700	200	Successful
4004701	400	Invalid Field Format {field name}
4004702	400	Invalid Mandatory Field {field name}
4014700	401	Unauthorized. [Reason]
4014701	401	Invalid Token (B2B)
4044708	404	Invalid Merchant
4044717	404	Invalid Terminal
4094700	409	Conflict
4094701	409	Duplicate partnerReferenceNo
5004700	500	General Error