Inquiry Transaction Status

Information

Here are the details information about the Inquiry Transaction Status API endpoint:

Method	Path	Format	Authentication
POST	`/api/v2.0/qris/status/{account_id}`	json	OAuth 2.0 with Access Token

Request

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

Request Parameters

The Inquiry Transaction Status API endpoint requires the following parameters:

Key	Data Type	Mandatory	Description	Example
reference_number	String	Yes	A unique 12-digit identifier generated by the system to track this specific transaction.	`735463554`
scope	String	Yes	The operational scope (e.g., “issuer”), indicating the entity processing the request.	`issuer`

Request Example

{
  "reference_number": "735463554",
  "scope": "issuer",
}

Response

Response Parameters

The Inquiry Transaction Status API endpoint will return the following parameters in the response:

Key	Data Type	Mandatory	Description
response_code	String	Yes	Response code (see Response Code appendix)
response_message	String	Yes	Response message (see Response Code appendix)
data	Object	No	The specific payload containing final transaction details.
> transaction_id	String	Yes	A unique, long-form system identifier for the transaction record (used for deep-level database queries).
> transaction_status	Object	Yes	The final state of the payment.
>> code	String	Yes	The status code (“00” typically signifies Success).
>> desc	String	Yes	Text description confirming the payment was successful.
> qr_data	String	Yes	The raw EMVCo string. This is the actual data encoded inside the QR code image.
> type	String	Yes	The QRIS model used. “mpm-dynamic” stands for Merchant Presented Mode (Dynamic), where the merchant shows a QR unique to that bill.
> scope	String	Yes	The operational scope (e.g., “issuer”), indicating the entity processing the request.
> reference_number	String	Yes	A unique 12-digit identifier generated by the system to track this specific transaction.
> post_timestamp	String	Yes	The Unix timestamp (in milliseconds) when the transaction was first created/posted.
> processed_timestamp	String	Yes	The Unix timestamp (in milliseconds) when the transaction reached its final status.
> balance_after	Object	No	The remaining balance in the merchant’s account after this transaction was completed.
>> value	String	Yes	Net amount for the transaction
>> currency	String	Yes	Currency of the transaction
> net_amount	Object	No	The Final Amount received by the merchant after deducting the fees.
>> value	String	Yes	Net amount for the transaction
>> currency	String	Yes	Currency of the transaction
> fee	Object	No	The transaction fee or service charge deducted from the transaction.
>> value	String	Yes	Fee amount for the transaction
>> currency	String	Yes	Currency of the transaction
> gross_amount	Object	No	The Total Amount paid by the customer `(Net + Fee)`.
>> value	String	Yes	Gross amount for the transaction
>> currency	String	Yes	Currency of the transaction

Response Example

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

{
  "response_code": "SP000",
  "response_message": "Successful",
  "data": {
    "transaction_id": "112220251111135424691",
    "transaction_status": {
      "code": "00",
      "desc": "Success"
    },
    "qr_data": "00020101021226620015ID.SINGAPAY.WWW0118936012070412260002021035224094080303UME51440014ID.CO.QRIS.WWW02153559174130477690303UME5204601153033605405110005802ID5903eos6005DEPOK6105746786221051017730486640703C0163044D76",
    "type": "mpm-dynamic",
    "scope": "issuer",
    "reference_number": "123456789123",
    "post_timestamp": "1762844064000",
    "processed_timestamp": "1762844065000",
    "balance_after": {
      "value": "120000.00",
      "currency": "IDR"
    },
    "net_amount": {
      "value": "21000.00",
      "currency": "IDR"
    },
    "fee": {
      "value": "500.00",
      "currency": "IDR"
    },
    "gross_amount": {
      "value": "21500.00",
      "currency": "IDR"
    }
  }
}

Error: Here’s an example of a validation error response.

{
  "response_code": "SP009",
  "response_message": "Timeout",
  "data": {
    "reference_number": "735463554",
    "type": "mpm",
    "scope": "issuer"
  }
}

On this page