Before creating a transaction, you may need to know if your participant has a valid certificate. The certificate has to be neither expired nor revoked.
To know if your participant has at least one valid certificate to perform an advanced or qualified signature, send a request to POST /v1/certificates/match and pass the participant email.
curl
https://api.universign.com/v1/certificates/match \
-d [email protected] \
You can set the following optional arguments:
min_certificate_level: The minimum certificate level required for the match. Possible values arelcp(Lightweight Certificate Policy),qcp(Qualified Certificate Policy) andqcpnqscd(Qualified Certificate Policy for Natural persons with keys generated in a QSCD).fullname: the participant full name.phone_number: the participant phone number.certificate_authority_name: the name of the certificate authority (CA) that issued the signature certificate. Note that the name of the certificate authority is defined by Universign and will be communicated by your account manager once your workspace is configured.
The API returns a certificate object with true value if at least one valid certificate is matching all constraints provided as query parameters.
{
"match_found": true
}
