Définir le nom du participant

Seul l’email du participant est obligatoire lors du paramétrage de votre transaction. Cependant, vous pouvez définir le nom du participant qui sera utilisé dans la transaction.

Vous devez transmettre deux arguments pour spécifier le nom du participant dans une transaction :

• full_name : permet de définir le nom complet du participant.

• full_name_type : permet de définir le type du nom complet du participant, parmi :

  • suggestion : vous donnez à Universign ou au signataire l’autorisation d’utiliser un nom complet différent qui pourrait être plus approprié. Cela signifie que le participant sera autorisé à modifier son nom sur la page de signature. Cela signifie également que si le participant possède déjà un certificat lié au même email sous un nom différent (le nom de son conjoint par exemple), Universign utilisera le nom du certificat à la place du nom que vous avez saisi dans la transaction.

  • prerequisite : vous n’autorisez pas Universign ni le signataire à utiliser un nom complet différent de celui que vous avez saisi. Cela signifie que le participant ne sera pas autorisé à modifier son nom sur la page de signature. Cela signifie également que si le participant possède déjà un certificat lié au même email sous un nom différent (nom de conjoint par exemple), Universign n’utilisera pas ce certificat. Si le niveau de signature demandé était level_1, nous ne mettrons pas à niveau la signature vers le niveau avancé, et si le niveau demandé était level_2, nous devrons créer un autre certificat et le participant devra effectuer une nouvelle vérification d’identité.

Définir le nom comme suggestion

Envoyez une requête POST /v1/transactions/{transaction_id}/participants en transmettant l’email du participant, le nom complet dans l’argument full_name, ainsi que suggestion dans l’argument full_name_type :

curl
https://api.universign.com/v1/transactions/tx_AWo949MOq0JE/participants \
-d [email protected] \
-d full_name=john \
-d full_name_type=suggestion

Définir le nom comme prérequis

Envoyez une requête à POST /v1/transactions/{transaction_id}/participants et transmettez l’email du participant, le nom complet dans l’argument full_name, ainsi que prerequisite dans l’argument full_name_type :

curl
https://api.universign.com/v1/transactions/tx_AWo949MOq0JE/participants \
-d [email protected] \
-d full_name=john \
-d full_name_type=prerequisite

Notez que si vous ne transmettez pas de full_name_type, la valeur par défaut est suggestion.

---

Demander l'édition d'un participant inconnu

← Précédent

Définir les moyens d’authentification

Suivant →