How to integrate eSignature into PHP Applications?

How to integrate eSignature into PHP Applications:

1. Step 2:

   Need to make a secure HTTP Callout to call the KAiZEN “Initiate Sign API” request as per the below details:

   HTTP Request Parameters

   Parameters Name	Value
   Content-Type	application/json
   Method	POST
   Endpoint	https://fa-kaizen-prod.azurewebsites.net/api/Sign/RequestStr?code=RTa1A0GW5Yl92OF54-73lRqglLFCt_0pVcg86hWf1EjtAzFuNROcdA==
   Body	JSON Body with parameters

   Request Body Parameters

   Parameters Name	Description	Required?
   docContent	Base64 Content for the PDF File	Yes
   docName	Name of the File	Yes
   appToken	Unique Code to initiate the request	Yes
   requesterEmail	Email address of the person initiating the request	Yes
   requesterName	Name of the person initiating the request	Yes
   description	Describes the document	NO
   signers	An array of the signers who needs to sign the document in the pre-defined order.	Yes
   CallBackURL	CallbackURL defines the url on which the KAiZEN should send a response once all the signers signs the document. It can be webservice url of Salesforce or any external page. Eg: https://duumy.my.salesforce- sites.com/services/apexrest/KaizenCallbackURL/	No
   newRequestEmailSubject	Describes the email subject	No
   requesterMessage	Describes the prompt eSignature field	No
   docDescription	Describes the document	No

2. Step 3:

   PHP Code Sample for Integration

   							
   							<?php
   require_once 'HTTP/Request2.php';
   $request = new HTTP_Request2();
   $request->setUrl('https://fa-kaizen-staging.azurewebsites.net/api/Sign/RequestStr?code=mLgEBTpi9dfooQ6TB9gc7sa4qiIuuxmqQYoTx8nQQ1StAzFu93g06A==');
   $request->setMethod(HTTP_Request2::METHOD_POST);
   $request->setConfig(array(
     'follow_redirects' => TRUE
   ));
   $request->setHeader(array(
     'Content-Type' => 'application/json'
   ));
   $request->setBody('{\n    "docContent":"<>",\n    "requesterEmail": "xyz@gmail.com",\n    "requesterName": "XYZ",\n    "requesterPhone": "xxxxx-xxx-xxxx",\n    "description" :"",\n    "newRequestEmailSubject":"You have a document to sign",\n    "requesterMessage": "Kindly eSign your KAiZEN Test PDF",\n    "signers": [\n        {\n            "signerEmail": "signer1@gmail.com",\n            "signerName": "Signer1",\n            "signerPhone": "xx-xxx-xxxx-xxx",\n            "order": "1",\n            "signerRole": "signer"\n               \n        },{\n            "signerEmail": "signer2@gmail.com",\n            "signerName": "Signer2",\n            "signerPhone": "xxx-xxx-xxxx-xxxx",\n            "order": "2",\n            "signerRole": "reviewer"\n               \n        }\n    ],\n    \n    "docDescription": "Base 64 string based test doc",\n    "callbackurl": ""\n}');
   try {
     $response = $request->send();
     if ($response->getStatus() == 200) {
       echo $response->getBody();
     }
     else {
       echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
       $response->getReasonPhrase();
     }
   }
   catch(HTTP_Request2_Exception $e) {
     echo 'Error: ' . $e->getMessage();
   }
   
   
   							
   						

   Sample HTTP Response:

   							
   								{
   “FailRules”: [],
   “Data”: {
   “SignRequestId”: “01HV6MEARQD3X8ZXXX5FR3YDB8”,
   “RequestNo”: “KAiZEN-118”
   }
   }
   							
   						

   Once the request is submitted, it will send a response with the request Id. If the callback url is configured, it will send a signed copy of the document on the defined url, once all the signers will sign and review the document.

   Once the request is sent out to the signers, each signer will receive an email to sign the document in the order as defined in the request.