QRIS - Generate - Singapay PG

Information

Method	Path	Format	Authentication
POST	`/api/v1.0/qris-dynamic/{account_id}/generate-qr`	json	OAuth 2.0 with Access Token

Request Details

Headers Structure

Field	Value	Type	Mandatory	Description	Example
X-PARTNER-ID	api_key	Alphanumeric	Mandatory	API key obtained from the merchant dashboard.	b3ed7d4b-a96c-6c08-b3c7-12c3124242d9
Accept	application/json	Alphabetic	Mandatory	Specifies JSON as the expected response format.	application/json
Authorization	Bearer {bearerToken}	Alphanumeric	Mandatory	Bearer token obtained from the get access token endpoint.	Bearer eyJ0eXAiOiJKV1{…}

Body Structure

Field	Type	Mandatory	Description	Example
amount	Numeric	Mandatory	Transaction amount	50000
expired_at	String	Mandatory	Expiration datetime (Y-m-d H:i:s)	2025-08-30 12:00:00
merchant_reff_no	String	Optional	Merchant reference number for tracing (max 255 characters). This value will be returned in webhook callback.	INV-2026-001

Body Example

{
    "amount": 50000,
    "expired_at": "2025-08-30 12:00:00",
    "merchant_reff_no": "INV-2026-001"
}

Response Details

Response Structure

Field	Type	Mandatory	Length	Description	Example
status	Numeric	Mandatory	3	HTTP Status Code	200
success	Boolean	Mandatory	1	2xx is true, 4xx-5xx is false	true
data	Object	Conditional		Transaction object
> id	Numeric	Mandatory		Account ID	2
> reff_no	String	Mandatory		Reference Number	6601K5WZZ71ZQ3KQJZZRV811XXHE
> merchant_reff_no	String/Null	Optional		Merchant reference number for tracing	INV-2026-001
> status	String	Mandatory		Transaction status	open
> type	String	Mandatory		Transaction type	mpm-dynamic
> amount	Numeric	Mandatory		Transaction amount	50000
> total_amount	Numeric	Mandatory		Total amount (amount)	52000
> qr_data	String	Mandatory		QRIS Data String	000201010212…
> expired_at	String	Mandatory		Expiration datetime (Y-m-d H:i:s)	2025-12-30 12:00:00
> created_at	String	Mandatory		Creation datetime (Y-m-d H:i:s)	2025-09-24 11:33:38

Response Example

Success: Here’s an example of a successful response.

{
    "status": 200,
    "success": true,
    "data": {
        "id": 2,
        "reff_no": "6601K5WZZ71ZQ3KQJZZRV811XXHE",
        "merchant_reff_no": "INV-2026-001",
        "status": "open",
        "type": "mpm-dynamic",
        "amount": 50000,
        "total_amount": 52000,
        "qr_data": "00020101021226570015ID.SINGAPAY.WWW01110509190001802122183098102390303UMI51440014ID.CO.QRIS.WWW02157434441747371980303UMI520472995303360540550000550202560420005802ID5923PT Tarsius Trusty Tahir6007Jakarta6105924396253051017586884180703C0108286601K5WZZ71ZQ3KQJZZRV811XXHE63042CEF",
        "expired_at": "2025-12-30 12:00:00",
        "created_at": "2025-09-24 11:33:38"
    }
}

Error: This is an example of an unsuccessful request.

{
    "message": "The expired at field must be a date after now.",
    "errors": {
        "expired_at": [
            "The expired at field must be a date after now."
        ]
    }
}

On this page