Top Up

Create Top Up Link

POST [BASE_URL]/open-api/v1/whitelabel/top-up/link

Purpose: Create top up link for users to view top up methods and instructions.

Request

Authorization:

• B2B Token

• B2B2C Token

Request Body

{}

Response

Response Body

{
    "code": "00",
    "data": {
        "paymentLink": "https://wallet-stg.harsya.com/whitelabel/top-up?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJ3YWxsZXQtYmFja2VuZCIsInN1YiI6IjAxOTdmNzdjLWVjMWUtNzUxYi05YWE5LTQ0NjNlMzc0ZmE0NSIsImV4cCI6MTc2MTcyNzc0NiwiaWRlbnRpZmllclZhbHVlIjoiMDE5N2Y3N2MtZWMxZS03NTFiLTlhYTktNDQ2M2UzNzRmYTQ1IiwibWVyY2hhbnRJZCI6Ijg4MDQyMTY4LWJmYTYtNGU1Yy1iY2NhLTVhYmYxZDQwYTE4MSJ9.9NRJ0l8o7ldVrGCOiteGD15EQGSxGy1t2vgqvQ9F19g",
        "expiredAt": "2025-10-29T15:49:06.351444017+07:00"
    },
    "message": "OK",
    "traceId": "ca5b457e6d0b323c758916c95e58a752"
}

Response Parameter Detail

Parameter	Data Type	Character Limit	Requirement	Description
code	String	5	Mandatory	Response status code. "00" indicates success, other codes indicate failure or specific error states.
data	Object	-	Mandatory	Contains the payment link and expiration details.
data.paymentLink	String (URL)	255	Mandatory	URL to redirect the user for payment completion or approval.
data.expiredAt	String (ISO 8601)	25	Mandatory	Expiration date and time of the payment link.
message	String	100	Mandatory	Human-readable message describing the result (e.g., "OK", "Invalid reference ID").
traceId	String	64	Optional	Unique identifier for tracking the API request, useful for troubleshooting and audit purposes.