If your customer did not linkup their account with SUBPLACE mobileID, which mean you did not store any SUBPLACE SSO token for the customer in your system. You should first calling this API.

By calling this API (without SSO token), the API will return a URL to get your customer consent for the following:

1. to create a new SUBPLACE if the mobile number of the customer does not appear as a mobileID in SUBPLACE system

2. to linkup the customer mobile number with SUBPLACE mobileID if the mobileID exist in SUBPLACE system.

{

    "status": {

        "code": 1,

        "message": "Success"

    },

    "subscriber": {

        "sso_url": "https://subplace.ownapp.asia/login/sso?token=86867BA0-2240-4847-8CA1-466F574CDEF8&hash=27e5c6178cf83e0785a6f569dd67e28493ce95b3c0fb69998d1f36748a1ee425&image=https://file.ownapp.asia/subplace_stage/admin/partner/a4c184beaac6a297955550de00c1b6db/thumbnail/7fbc4dac36900cc601eb15e9df64db17.webp&is_sso=1&redirect=%68%74%74%70%73%3A%2F%2F%73%75%62%70%6C%61%63%65%2E%6F%77%6E%61%70%70%2E%61%73%69%61%2F%70%6C%61%6E%2F%52%69%63%65%2D%42%61%6C%6C%2D%31%36%34%36%33%39%35%37%37%34%33%32%30%34%30%33%39%3F%72%65%66%65%72%65%6E%63%65%3D%31%32%33%35%2F%33%33%36%35%2F%32%32%34%35&bp_redirect=https://subplace_admin.ownapp.asia/login&bp_homepage=https://subplace_admin.ownapp.asia/login"

    }

}

After getting the URL above, you may redirect or embed the URL to access SUBPLACE account linkup page.

SUBPLACE system will first prompt customer with the mobile number that you pass in to the API. Customer may change the mobile number if the mobile number is incorrect or to another mobile number.

SUBPLACE will check if the mobile number exists as a mobileID in SUBPLACE.

If yes, an OTP will send to the mobile number and customer will be prompted to key in the OTP. If the submitted OTP is correct, the SSO token of the mobileID will be return via the "redirect url" to your system.

If no, SUBPLACE will prompt an account creation page to the customer. The customer need to fill in the detail and submit. SUBPLACE will create an account with the mobile number and send an OTP to the mobile number and request customer to key in the OTP for mobile number verification. After OTP done, the SSO token of the new mobileID will be return via the "redirect url" to your system.

Please make sure you provide a URL that can capture the return SSO token and save the SSO token to your customer profile and then use the SSO token to call the Direct Login URL API.