Upgrade User

POST [BASE_URL]/open-api/v1/whitelabel/user/upgrade/request

Purpose: Request user level upgrade

Authorization:

• B2B Token

• B2B2C Token

Content Type: multipart/form-data

identityNumber=1234567890123456
fullName=John Doe
pob=Jakarta
dob=1990-01-01
nationality=Indonesian
domicileAddress=Jl. Sudirman No. 1
domicileCity=Jakarta
domicileProvince=DKI Jakarta
domicilePostcode=10110
province=DKI Jakarta
city=Jakarta
postalCode=10110
address=Jl. Sudirman No. 1
occupation=Software Engineer
gender=MALE
redirectUrl=https://merchant.com/upgrade/success
selfie=<file_upload>
identity=<file_upload>

Request Parameter Detail

Parameter	Data Type	Character Limit	Requirement	Description
selfie	Object	-	Optional	Contains selfie file, signed URL
identity	Object	-	Optional	Contains identity file, signed URL
identityNumber	String	32	Optional	National ID number (e.g., NIK for WNI, Passport number for WNA).
identityType	String	10	Optional	Type of identity document: KTP, Passport, KITAS, or KITAP.
fullName	String	100	Optional	User’s full name as stated on the identity document.
pob	String	50	Optional	User’s place of birth.
dob	String (YYYY-MM-DD)	10	Optional	User’s date of birth.
nationality	String	3	Optional	User’s nationality: WNI or WNA
domicileAddress	String	255	Optional	User’s current address.
domicileProvince	String	50	Optional	Province of domicile address.
domicileCity	String	50	Optional	City of domicile address.
domicilePostcode	String	10	Optional	Postal code of domicile address.
province	String	50	Optional	Province as per ID document.
city	String	50	Optional	City as per ID document.
postalCode	String	10	Optional	Postal code as per ID document.
address	String	255	Optional	Permanent address as per ID document.
occupation	String	50	Optional	User’s occupation or job title.
gender	String	10	Optional	User’s gender: Male or Female.
redirectUrl	String (URL)	255	Optional	URL to redirect the user after activation is completed.

Response

Response Body

{
    "code": "00",
    "data": {
        "link": "https://wallet-stg.harsya.com/whitelabel/user/upgrade?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJ3YWxsZXQtYmFja2VuZCIsInN1YiI6IjE0NzFlNGFjLTI3N2ItNGJiNi04MmQ4LWFlZTY4ODNhNTg2ZCIsImV4cCI6MTc2MTgxOTgxMiwiaWRlbnRpZmllclZhbHVlIjoiMTQ3MWU0YWMtMjc3Yi00YmI2LTgyZDgtYWVlNjg4M2E1ODZkIiwibWVyY2hhbnRJZCI6Ijg4MDQyMTY4LWJmYTYtNGU1Yy1iY2NhLTVhYmYxZDQwYTE4MSIsInNlc3Npb25JZCI6IjE0NzFlNGFjLTI3N2ItNGJiNi04MmQ4LWFlZTY4ODNhNTg2ZCJ9.IwdNQuCvbyn8fvQOEL3TNi6-6gUKoO4QcHEN4rSsyEU",
        "expiredAt": "2025-10-30T17:23:32+07:00"
    },
    "message": "OK",
    "traceId": "437eb9286e45ed66b5fcdb4f75fe4746"
}

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.link	String (URL)	255	Mandatory	Upgrade 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).