Topremit
OPEN APITopremit
OPEN APITopremit
  1. QRIS
  • Open API
    • Virtual Account
      • Create Virtual Account
      • Inquiry Status Virtual Account
      • Virtual Account Callback
      • Cancel Virtual Account
      • Simulate Virtual Account Payment (Test Mode Only)
    • QRIS
      • Create QRIS
        POST
      • Inquiry QRIS
        POST
      • QRIS Callback
        POST
      • Simulate QRIS Payment (Test Mode Only)
        POST
    • Fetch Access Token
      POST
  1. QRIS

Create QRIS

Developing
POST
/pg/snap/v1/qr/qr-mpm-generate
Last modified:2025-05-19 04:30:05
This API is used when initiating a customer payment (e.g., in an e-commerce checkout, POS system, or mobile app) where the customer will scan a QR code to pay.
Generate a dynamic QRIS code for a specific transaction. This QR code can be scanned by any Indonesian e-wallet or mobile banking app that supports QRIS, enabling instant payments.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://staging-uno.topremit.com/pg/snap/v1/qr/qr-mpm-generate' \
--header 'Authorization;' \
--header 'CHANNEL-ID;' \
--header 'X-TIMESTAMP;' \
--header 'X-SIGNATURE;' \
--header 'X-PARTNER-ID;' \
--header 'X-EXTERNAL-ID;' \
--header 'Content-type:  application/json' \
--data-raw '{
    "partnerReferenceNo": "string",
    "amount": {
        "value": "string",
        "currency": "string"
    },
    "additionalInfo": {
        "expirationDate": "string",
        "description": "string"
    }
}'
Response Response Example
{
    "responseCode": "string",
    "responseMessage": "string",
    "partnerReferenceNo": "string",
    "qrContent": "string",
    "additionalInfo": {
        "paymentId": "string",
        "qrisInvoiceId": "string",
        "status": "string",
        "expiredDate": "string",
        "description": "string",
        "createdAt": "string"
    }
}

Request

Header Params
Content-type
string 
required
Only accept application/json
Example:
application/json
Authorization
string 
required
Bearer token for authentication
CHANNEL-ID
string 
required
Unique identifier for the channel
X-TIMESTAMP
string 
required
Client's current local time in ISO 8601 format: yyyy-MM- ddTHH:mm:ssTZD.
e.g., 2025-05-15T12:34:31+07:00
X-SIGNATURE
string 
required
Format: HMAC_SHA512 (clientSecret, stringToSign) with stringToSign = HTTPMethod +":"+ EndpointUrl +":"+ AccessToken +":"+ Lowercase(HexEncode(SHA256(minify(RequestBody))))+ ":" + X-TimeStamp
X-PARTNER-ID
string 
required
Your assigned Client ID
X-EXTERNAL-ID
string 
required
Unique idempotency key for the request (valid for at least 24 hours)
Body Params application/json
partnerReferenceNo
string 
required
Unique transaction ID provided by the merchant. Please note that this field needs to be unique for each payments.
amount
object 
required
value
string 
required
Format should include 2 decimal places
currency
string 
required
Only IDR is allowed
additionalInfo
object 
required
expirationDate
string 
optional
Format: ISO-8601
description
string 
optional
Description/Notes of the VA
Examples

Responses

🟢200Success
application/json
Body
responseCode
string 
required
2004700
responseMessage
string 
required
partnerReferenceNo
string 
required
Merchant provided payment identifier
qrContent
string 
required
additionalInfo
object 
required
paymentId
string 
required
Payment Id Generated by System
qrisInvoiceId
string 
optional
status
string 
required
expiredDate
string 
required
description
string 
required
createdAt
string 
required
Previous
QRIS
Next
Inquiry QRIS
Built with