Configuration de Postman pour créer une transaction Universign

Cette documentation explique comment configurer Postman afin de créer une transaction de signature avec Universign.

1. Environnement de test et de production

L'exemple ci-dessous est basé sur l'environnement de recette.
Si vous souhaitez utiliser l'environnement de production, vous devrez modifier l'URL de l’API en conséquence.

2. Configuration de la requête

Méthode HTTP

📌 POST

URL de l’API

• Environnement de recette : [URL_SANDBOX]
• Environnement de production : [URL_PRODUCTION]

Headers à inclure

Ajoutez ces headers dans Postman :

Content-Type: text/xml

3. Contenu du body à utiliser

Copiez-collez le contenu XML ci-dessous dans l’onglet Body de Postman (mode raw) :

<?xml version="1.0" encoding="UTF-8"?>
<methodCall>
  <methodName>requester.requestTransaction</methodName>
  <params>
    <param>
      <value>
        <struct>
          <member>
            <name>profile</name>
            <value><string>default</string></value>
          </member>
          <member>
            <name>mustContactFirstSigner</name>
            <value><boolean>0</boolean></value>
          </member>
          <member>
            <name>finalDocSent</name>
            <value><boolean>1</boolean></value>
          </member>
          <member>
            <name>finalDocRequesterSent</name>
            <value><boolean>1</boolean></value>
          </member>
          <member>
            <name>description</name>
            <value><string>Collecte de démo</string></value>
          </member>
          <member>
            <name>language</name>
            <value><string>fr</string></value>
          </member>
          <member>
            <name>handwrittenSignatureMode</name>
            <value><int>0</int></value>
          </member>
          <member>
            <name>chainingMode</name>
            <value><string>email</string></value>
          </member>
          <member>
            <name>signers</name>
            <value>
              <array>
                <data>
                  <value>
                    <struct>
                      <member>
                        <name>firstname</name>
                        <value><string>Signer 1</string></value>
                      </member>
                      <member>
                        <name>lastname</name>
                        <value><string>(test)</string></value>
                      </member>
                      <member>
                        <name>emailAddress</name>
                        <value><string>[e-mail]</string></value>
                      </member>
                      <member>
                        <name>successURL</name>
                        <value><string>https://www.universign.com</string></value>
                      </member>
                      <member>
                        <name>cancelURL</name>
                        <value><string>https://www.universign.com</string></value>
                      </member>
                      <member>
                        <name>failURL</name>
                        <value><string>https://www.universign.com</string></value>
                      </member>
                      <member>
                        <name>certificateType</name>
                        <value><string>simple</string></value>
                      </member>
                    </struct>
                  </value>
                </data>
              </array>
            </value>
          </member>
          <member>
            <name>documents</name>
            <value>
              <array>
                <data>
                  <value>
                    <struct>
                      <member>
                        <name>documentType</name>
                        <value><string>pdf</string></value>
                      </member>
                      <member>
                        <name>content</name>
                        <value><base64>contenu du fichier en base64</base64></value>
                      </member>
                      <member>
                        <name>name</name>
                        <value><string>doc.pdf</string></value>
                      </member>
                    </struct>
                  </value>
                </data>
              </array>
            </value>
          </member>
        </struct>
      </value>
    </param>
  </params>
</methodCall>

4. Exécution de la requête

Après avoir renseigné tous les paramètres :

1. Cliquez sur Send.
2. Vérifiez la réponse de l’API pour confirmer la création de la transaction.