User Activation

Create User Activation Link

POST [BASE_URL]/open-api/v1/whitelabel/user/activation

Purpose: Create and bind account.

Authorization:

• B2B Token

Request

Request Body

{
 "phoneNumber": "6281234567890",
 "referenceId": "CUSTOMER_REF_001",
 "redirectUrl": "https://merchant.com/success",
 "name": "John Doe"
}

Request Parameter Detail

Parameter	Data Type	Character Limit	Requirement	Description
phoneNumber	String	15	Mandatory	User’s phone number in MSISDN format (e.g., 6281234567890).
referenceId	String	64	Mandatory	Merchant’s unique user ID or reference number.
name	String	50	Optional	User name
redirectUrl	String (URL)	255	Optional	URL to redirect the user after activation is completed.

Response

Response Body

{
    "code": "00",
    "data": {
        "activationLink": "https://webview.harsya.com/whitelabel/user/activation?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJ3YWxsZXQtYmFja2VuZCIsInN1YiI6IjA4OTYzMTIzODkyMCIsImV4cCI6MTczNzM5Mjk5MSwiaWRlbmZpZXJWYWx1ZSI6IjA4OTYzMTIzODkyMCIsIm1lcmNoYW50SWQiOiI5MjJlMzlhYi03NTY1LTQ5ZjYtYjg0Zi1mYjU2MTIyODIxYWUifQ.LrDTuU40-G7z2VK8SdehI--iSLn7IMo5OSzBSzTTOGY",
        "expiredAt": "2025-01-21T00:09:51+07:00"
    },
    "message": "OK"
}

Response Parameter Detail

Parameter	Data Type	Character Limit	Requirement	Description
code	String	5	Mandatory	Response status code. "00" indicates success, other codes indicate errors.
data	Object	-	Mandatory	Contains the activation link and expiration details.
data.activationLink	String (URL)	255	Mandatory	Activation URL that redirects the user to complete their onboarding or KYC process.
data.expiredAt	String (ISO 8601)	25	Mandatory	Expiration date and time of the activation link.
message	String	100	Mandatory	Description of the API result (e.g., "OK" or error message).