Path/ordersnap/api/v1.0/qr/qr-mpm-generate
HTTP MethodPOST
Versionv1.0
Service Code47

Request Header

Field NameField TypeMandatoryField Description
Content-typeStringMMedia type of the resource, i.e. application/json
X-TIMESTAMPStringMClient’s current local time in ISO-8601 format
X-SIGNATUREStringMCreated using symmetric signature HMAC_SHA512 algorithm. Read here
AuthorizationStringMRepresents 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-IDStringMUnique identifier for caller (client_id)
X-EXTERNAL-IDStringMMerchant’s unique ID per transaction request
CHANNEL-IDStringMPJP’s channel id.

Example Header

Field NameValue
Content-typeapplication/json
X-TIMESTAMP2024-03-19T14:30:00+07:00
X-SIGNATUREda1fa417c72d6b91c257e01e54fac824
AuthorizationBearer gp9HjjEj813Y9JGoqwOeOPWbnt4CupvIJbU1Mmu4a11MNDZ7Sg5u9a
X-PARTNER-ID7fb118fb-2738-4886-9817-8a2c4de43001
X-EXTERNAL-ID41807553358950093184162180797837
CHANNEL-ID95221

Request Body

Field NameField TypeMandatoryField Description
partnerReferenceNoString(36)MAlphanumeric 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
amountObjectMAmount object
amount.valueString(16,2)MTransaction amount
amount.currencyString(3)MTransaction currency
merchantIdString(64)OMerchant identifier that is unique per each merchant
subMerchantIdString(32)OSub merchant ID
storeIdString(64)OStore ID
terminalIdString(16)OMerchant terminal id
validityPeriodString(25)MThe time when the QRIS will automatically expire. The time when the payment will be automatically expired. The format is defined by ISO 8601.
additionalInfoObjectMAdditional information
additionalInfo.acquirerIntegerMID Acquirer
additionalInfo.ItemsArray of ObjectMItems Object
additionalInfo.Items.idStringMID Items
additionalInfo.Items.priceStringMPrice Object
additionalInfo.Items.price.valueStringMPrice value
additionalInfo.Items.price.currencyStringMTransaction currency
additionalInfo.Items.quantityStringMQuantity of items
additionalInfo.Items.nameStringMItems Name
additionalInfo.Items.brandStringOBrand Items
additionalInfo.Items.categoryStringOCategory items
additionalInfo.Items.merchantNameStringOMerchant Name
additionalInfo.customerDetailsObjectMObject Costumer Details
additionalInfo.customerDetails.emailStringMEmail Customer
additionalInfo.customerDetails.firstNameStringMFirst name customer
additionalInfo.customerDetails.lastNameStringMLast name customer
additionalInfo.customerDetails.phoneStringMPhone number customer
additionalInfo.metadataObjectOObject containing the metadata parameters.
additionalInfo.countryCodeStringOCode Country
additionalInfo.localeStringOSpecifies 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 NameField TypeMandatoryField Description
additionalInfoObjectMAdditional Information
additionalInfo.acquirerIntegerMID Acquirer
additionalInfo.amountObjectMAmount Object
additionalInfo.amount.currencyStringMAmount currency
additionalInfo.amount.valueStringMAmount value
additionalInfo.createdAtObjectMObject transaction created
additionalInfo.createdAt.dateTimeStringMDatetime transaction created
merchantNameStringOMerchant name
partnerReferenceNoString (36)OpartnerReferenceNo from the request body
qrContentString(512)CQR String MPM.
If qrContent is null, then qrUrl or qrImage must be filled.
qrImageStringObase64 from image QRIS.
Max length is unlimited.
qrUrlStringOQR URL for download QR Image
referenceNoString (64)OTransaction identifier on service provider system.
responseCodeString (7)MResponse Code (HTTP status code + service code + case code)
responseMessageString (150)MDescription of charge result response.
storeIdStringOunique shop id on the merchant side.
terminalIdStringOMerchant 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 CodeHTTP StatusDescription
2004700200Successful
4004700400X-TIMESTAMP is not valid
4004701400Invalid Field Format
4004702400Invalid Mandatory Field
4014700401Unauthorized. [Invalid Signature]
4044708404Invalid Merchant
4044717404Invalid Terminal
4094701409Duplicate partnerReferenceNo
5004701500Internal server error - temp storage