Before you request level2
or higher signatures, you may want your participant to possess the appropriate certificate.
Universign standalone registration service allows you to initiate a certificate request session for your future participant.
To do so, send a request to POST /v1/registrations
and pass the future participant email in the applicant
argument, the required certificate level
, standalone
in the session_type
argument as well as the redirect_url
.
curl
https://api.universign.com/v1/registrations \
-d applicant=john@universign.com \
-d level="qcp" \
-d redirect_url=https://www.myredirecturl.com \
-d session_type="standalone"
You can pass optional parameters:
fullname
: The applicant’s full namefullname_type
: The applicant’s full name type. Accepted values aresuggestion
(if you allow the applicant to edit his/her name on the registration page) orprerequisite
(if you don’t allow the applicant to edit his/her name on the registration page). Default value issuggestion
.phone_number
: The applicant’s phone number that will be used to authenticate during the registration process.phone_number_type
: The applicant’s mobile number type. Accepted values aresuggestion
(if you allow the applicant to edit his/her phone number during the registration),flex_prerequisite
(if you allow the applicant to edit his/her phone number during the registration), orprerequisite
(if you never allow the applicant to edit his/her phone number during the registration). Default value issuggestion
.language
: The language used for the certificate agreement. Expected input format is ISO 639-1. We currently support 11 languages: Bulgarian (bg
), Catalan (ca
), Dutch (nl
), English (en
), French (fr
), German (de
), Italian (it
), Polish (pl
), Portuguese (pt
), Romanian (ro
) and Spanish (es
). French (fr
) is the default language.
The API returns a registration
field with the registration ID
, state
and access url
.
{
"id" : "reg_5X",
"state" : "open",
"url" : "https://apps.universign.com/registration/reg_5X?token=generated_token"
}