About certificate creation
Before you request an advanced signature (level2
) or an advanced signature with a qualified certificate (level3
) , you may want your participant to possess the appropriate certificate.
Universign Certificates service allows you to initiate a request to verify your future participant’s ID and issue, if successful, the appropriate certificate. For more details, visit Certificates.
A registration session is valid only for 7 days. Beyond this delay, you need to initiate another registration session.
Note that a participant can own several certificates.
Request certificate creation
To request a certificate creation, send a request to POST /v1/registrations
and pass the following required parameters:
applicant
: the future participant e-mail.level
: the required certificate level. Possible values arelcp
(Light Certificate Policy),qcp
(Qualified Certificate Policy) orqcpnqscd
(Qualified Certificate Policy for Natural persons with keys generated in a QSCD).
curl
https://api.universign.com/v1/registrations \
-d applicant=john@universign.com \
-d level=qcp \
You can pass the follwing optional arguments:
redirect_url
: the URL to which you want to redirect the applicant onece the registration session is completed.fullname
: the applicant’s full name. If the applicant has several first or last names, they must be separated by a space.fullname_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. Expected format is E.164 ([+] [country code] [phone number including area code]) (e.g. +33612345678).phone_number_type
: the applicant’s mobile number type. Accepted values are suggestion (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 url
.
Note that you can create webhooks to follow your applicant’s registration status. For more details, visit Registration Events.