QRIS - List - Singapay PG

Information

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

Request Details

Query Parameters for Filtering

Parameter	Type	Mandatory	Description	Example
reff_no	String	Optional	Filter by reference number (partial match)	6601K5WZG32XJB5RSZB80XC9E2MC
status	String	Optional	Filter by transaction status	open
type	String	Optional	Filter by transaction type	mpm-dynamic
amount	Numeric	Optional	Filter by exact amount	100000
amount_min	Numeric	Optional	Filter by minimum amount	50000
amount_max	Numeric	Optional	Filter by maximum amount	500000
total_amount	Numeric	Optional	Filter by exact total amount	100000
total_amount_min	Numeric	Optional	Filter by minimum total amount	50000
total_amount_max	Numeric	Optional	Filter by maximum total amount	500000
has_settle	Boolean	Optional	Filter by settlement status	true
created_at_from	String	Optional	Filter by minimum creation date (Y-m-d H:i:s)	2025-09-24 00:00:00
created_at_to	String	Optional	Filter by maximum creation date (Y-m-d H:i:s)	2025-09-24 23:59:59
expired_at_from	String	Optional	Filter by minimum expiration date (Y-m-d H:i:s)	2025-09-24 00:00:00
expired_at_to	String	Optional	Filter by maximum expiration date (Y-m-d H:i:s)	2025-09-30 23:59:59
settle_at_from	String	Optional	Filter by minimum settlement date (Y-m-d H:i:s)	2025-09-24 00:00:00
settle_at_to	String	Optional	Filter by maximum settlement date (Y-m-d H:i:s)	2025-09-30 23:59:59
sort_by	String	Optional	Sort by field (default: id)	id, created_at, amount
sort_order	String	Optional	Sort order (default: desc)	asc, desc
per_page	Integer	Optional	Items per page (default: 25)	25, 50, 100

Headers Structure

Header	Type	Mandatory	Description	Example
X-PARTNER-ID	String	Mandatory	Partner ID from merchant dashboard	b3ed7d4b-a96c-6c08-b3c7-12c3124242d9
Accept	String	Mandatory	Response format	application/json
Authorization	String	Mandatory	Bearer token from auth endpoint	Bearer eyJ0eXAiOiJKV1QiLCJhb…

Request Example with Filters

Example 1: Filter by Status and Amount Range

GET /api/v1.0/qris-dynamic/01K8AESCCKYSD98Z3P9RSDA36W?status=open&amount_min=50000&amount_max=500000&sort_by=created_at&sort_order=desc

cURL Example:

curl -X GET "https://api.singapay.id/api/v1.0/qris-dynamic/01K8AESCCKYSD98Z3P9RSDA36W?status=open&amount_min=50000&amount_max=500000&sort_by=created_at&sort_order=desc" \
  -H "X-PARTNER-ID: b3ed7d4b-a96c-6c08-b3c7-12c3124242d9" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..."

Example 2: Filter by Settlement Status and Date Range

GET /api/v1.0/qris-dynamic/01K8AESCCKYSD98Z3P9RSDA36W?has_settle=true&created_at_from=2025-09-24 00:00:00&created_at_to=2025-09-24 23:59:59

cURL Example:

curl -X GET "https://api.singapay.id/api/v1.0/qris-dynamic/01K8AESCCKYSD98Z3P9RSDA36W?has_settle=true&created_at_from=2025-09-24%2000:00:00&created_at_to=2025-09-24%2023:59:59" \
  -H "X-PARTNER-ID: b3ed7d4b-a96c-6c08-b3c7-12c3124242d9" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..."

Example 3: Filter by Reference Number and Type

GET /api/v1.0/qris-dynamic/01K8AESCCKYSD98Z3P9RSDA36W?reff_no=6601K5WZG32XJB5RSZB80XC9E2MC&type=mpm-dynamic

cURL Example:

curl -X GET "https://api.singapay.id/api/v1.0/qris-dynamic/01K8AESCCKYSD98Z3P9RSDA36W?reff_no=6601K5WZG32XJB5RSZB80XC9E2MC&type=mpm-dynamic" \
  -H "X-PARTNER-ID: b3ed7d4b-a96c-6c08-b3c7-12c3124242d9" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..."

Example 4: Filter by Total Amount Range and Settlement Date

GET /api/v1.0/qris-dynamic/01K8AESCCKYSD98Z3P9RSDA36W?total_amount_min=100000&total_amount_max=2000000&settle_at_from=2025-09-24 00:00:00&settle_at_to=2025-09-30 23:59:59

cURL Example:

curl -X GET "https://api.singapay.id/api/v1.0/qris-dynamic/01K8AESCCKYSD98Z3P9RSDA36W?total_amount_min=100000&total_amount_max=2000000&settle_at_from=2025-09-24%2000:00:00&settle_at_to=2025-09-30%2023:59:59" \
  -H "X-PARTNER-ID: b3ed7d4b-a96c-6c08-b3c7-12c3124242d9" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..."

Example 5: Filter by Expiration Date and Pagination

GET /api/v1.0/qris-dynamic/01K8AESCCKYSD98Z3P9RSDA36W?expired_at_from=2025-09-24 00:00:00&expired_at_to=2025-09-30 23:59:59&per_page=50&page=1

cURL Example:

curl -X GET "https://api.singapay.id/api/v1.0/qris-dynamic/01K8AESCCKYSD98Z3P9RSDA36W?expired_at_from=2025-09-24%2000:00:00&expired_at_to=2025-09-30%2023:59:59&per_page=50&page=1" \
  -H "X-PARTNER-ID: b3ed7d4b-a96c-6c08-b3c7-12c3124242d9" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..."

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{…}

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	Array Object	Conditional		Array of QRIS transaction objects
> id	Numeric	Mandatory		Transaction ID	1
> reff_no	String	Mandatory		Reference Number	6601K5WZG32XJB5RSZB80XC9E2MC
> 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	100000
> total_amount	Numeric	Mandatory		Total amount (amount)	100000
> qr_data	String	Mandatory		QRIS Data String	000201010212…
> expired_at	String	Mandatory		Expiration datetime (Y-m-d H:i:s)	2025-09-24 12:25:00
> created_at	String	Mandatory		Creation datetime (Y-m-d H:i:s)	2025-09-24 11:25:23
> has_settle	Boolean	Mandatory		Indicates whether the transaction has been settled	true
> settle_at	String/Null	Optional		Settlement datetime (Y-m-d H:i:s)	2025-09-24 13:25:00
pagination	Object	Mandatory	-	Object containing pagination metadata.	-
> count	Numeric	Mandatory	-	Number of items in the current page.	1
> total	Numeric	Mandatory	-	Total number of items across all pages.	1
> perPage	Numeric	Mandatory	-	Items per page setting.	25
> currentPage	Numeric	Mandatory	-	The current page number.	1
> totalPages	Numeric	Mandatory	-	The total number of pages.	1
> links	Object	Mandatory	-	Object containing pagination links.

Response Example

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

{
    "status": 200,
    "success": true,
    "data": [
        {
            "id": 1,
            "reff_no": "6601K5WZG32XJB5RSZB80XC9E2MC",
            "merchant_reff_no": "INV-2026-001",
            "status": "open",
            "type": "mpm-dynamic",
            "amount": 100000,
            "total_amount": 100000,
            "qr_data": "00020101021226570015ID.SINGAPAY.WWW01110509190001802122183098102390303UMI51440014ID.CO.QRIS.WWW02157434441747371980303UMI52047299530336054061000005802ID5923PT Tarsius Trusty Tahir6007Jakarta6105924396253051017586879230703C0108286601K5WZG32XJB5RSZB80XC9E2MC6304DCCC",
            "expired_at": "2025-09-24 12:25:00",
            "created_at": "2025-09-24 11:25:23",
            "has_settle": true,
            "settle_at": "2025-09-24 13:25:00"
        }
    ],
    "pagination": {
        "count": 1,
        "total": 1,
        "perPage": 25,
        "currentPage": 1,
        "totalPages": 1,
        "links": {}
    }
}

On this page