QRIS Payment

Create QRIS Payment Link

POST [BASE_URL]/open-api/v1/whitelabel/qris/link

Purpose: Create QRIS payment link for users to scan QRIS and make payment using balance.

Request

Authorization:

• B2B Token

• B2B2C Token

Request Body

{
    "referenceId":"ref-{{randomReferenceId}}",
    "redirectionUrl":"https://google.com",
    "failedRedirectionUrl":"https://youtube.com",
    "mode":"JIT"
}

Request Parameter Detail

Parameter	Data Type	Character Limit	Requirement	Description
referenceId	String	64	Mandatory	Unique reference number generated by the merchant to identify and track the transaction.
redirectionUrl	String (URL)	255	Mandatory	URL to redirect the user after the transaction is successfully processed.
failedRedirectionUrl	String (URL)	255	Optional	URL to redirect the user if the transaction fails or is canceled.
mode	String	10	Optional	Transaction mode. "JIT" (Just-In-Time) means the wallet will be funded only at the moment of payment.

Response

Response Body

{
    "code": "00",
    "data": {
        "paymentLink": "https://wallet-stg.harsya.com/whitelabel/qris-payment?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJ3YWxsZXQtYmFja2VuZCIsInN1YiI6IjE0NzFlNGFjLTI3N2ItNGJiNi04MmQ4LWFlZTY4ODNhNTg2ZCIsImV4cCI6MTc2MTczNTE0MSwiaWRlbnRpZmllclZhbHVlIjoiMTQ3MWU0YWMtMjc3Yi00YmI2LTgyZDgtYWVlNjg4M2E1ODZkIiwibWVyY2hhbnRJZCI6Ijg4MDQyMTY4LWJmYTYtNGU1Yy1iY2NhLTVhYmYxZDQwYTE4MSJ9.DaAXomLUaG0blkoozHxKvuOqXN1TUV9DGp6cRCuOIgs",
        "expiredAt": "2025-10-29T17:52:21.831019424+07:00"
    },
    "message": "OK",
    "traceId": "8c22010caf941209d17ca0ada155f2fd"
}

Response Parameter Detail

Parameter	Data Type	Character Limit	Requirement	Description
code	String	5	Mandatory	Response status code. "00" indicates the request was successful.
data	Object	-	Mandatory	Contains payment link details and expiration timestamp.
data.paymentLink	String (URL)	255	Mandatory	URL to the QRIS payment page for the user to complete the transaction. Includes a secure token for validation.
data.expiredAt	String (ISO 8601)	30	Mandatory	Expiration timestamp of the payment link. After this time, the link becomes invalid.
message	String	100	Mandatory	Descriptive message of the operation result (e.g., "OK", "Invalid request").
traceId	String	64	Optional	Unique identifier for tracing and debugging the API call across systems.