Request certificate creation

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 name
  • fullname_type: The applicant’s full name type. Accepted values are suggestion (if you allow the applicant to edit his/her name on the registration page) or prerequisite (if you don’t allow the applicant to edit his/her name on the registration page). Default value is suggestion.
  • 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 are suggestion (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), or prerequisite (if you never allow the applicant to edit his/her phone number during the registration). Default value is suggestion.
  • 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"
}

Developer tools
Guides
Services
API reference