Merchant Payment

Create Merchant Payment Link

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

Purpose: Create payment link for users to make payment to merchant using balance

Request

Authorization:

• B2B Token

• B2B2C Token

Request Body

{
    "merchantId":"{{whitelabelMerchantId}}",
    "amount":550,
    "referenceId": "ref-id-202",
    "remarks":"testing remarks",
    "redirectionUrl":"https://www.google.com",
    "failedRedirectionUrl":"https://www.youtube.com"
}

Request Parameter Detail

merchantId	String (UUID)	64	Mandatory	Unique identifier assigned to the merchant/submerchant by the system.
amount	Number (Integer)	-	Mandatory	Payment amount in the smallest currency unit (IDR).
referenceId	String	64	Mandatory	Unique transaction reference number generated by the merchant for idempotency.
remarks	String	255	Optional	Additional notes or remarks for the payment (e.g., invoice number or purpose).
redirectionUrl	String (URL)	255	Mandatory	URL to which the user will be redirected after successful payment.
failedRedirectionUrl	String (URL)	255	Optional	URL to redirect the user if payment fails or is canceled.

Response

Response Body

{
    "code": "00",
    "data": {
        "paymentLink": "https://wallet-stg.harsya.com/whitelabel/payment?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJ3YWxsZXQtYmFja2VuZCIsInN1YiI6IjE0NzFlNGFjLTI3N2ItNGJiNi04MmQ4LWFlZTY4ODNhNTg2ZCIsImV4cCI6MTc2MTczMzA3MywiaWRlbnRpZmllclZhbHVlIjoiMTQ3MWU0YWMtMjc3Yi00YmI2LTgyZDgtYWVlNjg4M2E1ODZkIiwibWVyY2hhbnRJZCI6Ijg4MDQyMTY4LWJmYTYtNGU1Yy1iY2NhLTVhYmYxZDQwYTE4MSIsInNlc3Npb25JZCI6IjAxOWEyZjZiLWEwNzEtNzgwYy1hZTJiLTY5ZmY2YTc4YjU3ZSJ9.9HWUDE3cpZiT8DaCfuzSB_lP5JzJ7ZvkLkjV4gIuGGQ",
        "expiredAt": "2025-10-29T17:17:53.943254106+07:00",
        "referenceId": "019a2f6b-a071-780c-ae2b-69ff6a78b57e"
    },
    "message": "OK",
    "traceId": "27a14d28784ab1455ea769022de4b668"
}

Response Parameter Detail

Parameter	Data Type	Character Limit	Requirement	Description
code	String	5	Mandatory	Response status code. "00" indicates success, other values indicate specific errors.
data	Object	-	Mandatory	Contains details of the generated payment link and related metadata.
data.paymentLink	String (URL)	255	Mandatory	URL directing the user to the payment page. The link includes a secure token for session validation.
data.expiredAt	String (ISO 8601)	30	Mandatory	Expiration timestamp of the payment link. After this time, the link becomes invalid.
data.referenceId	String (UUID)	36	Mandatory	Unique identifier associated with the payment request, matching the original reference ID.
message	String	100	Mandatory	Message describing the result of the operation (e.g., "OK" or error message).
traceId	String	64	Optional	Unique ID for tracing and debugging the request across systems.