The BoldSign mobile app is now available. Visitthis link for more details and give it a try!
The BoldSign mobile app is now available. Visitthis link for more details and give it a try!
Explore the BoldSign features that make eSigning easier.
Next, you’ll need an API key to authenticate your access. The API key is located on the API Key – BoldSign page. We will use this API key in our Python code later on.
You can either use your existing Python Flask application or build a new one:
from flask import Flask
app = Flask(__name__)
@app.route('/')
def home():
return 'Hello, World!'
if __name__ == '__main__':
app.run(debug=True)
First, we should create a BoldSign template that will be used in the application to send documents out for signature. A new template can be created using BoldSign APIs or through the BoldSign web application. The template should include all the essential elements required for the customer contract signing scenario.
With all the necessary steps completed, we are now all set to embed the BoldSign for our customer contract signing scenario. We will incorporate the following functionalities in the application:
With the template successfully created for our scenario, we can now utilize the BoldSign send API to initiate the signing process. In the send API, it is necessary to provide the template ID and the required form details.
To implement this in our app.py route “/”, we can call the send template API to retrieve the template ID. Following is an example snippet of Python code that demonstrates this functionality.
@app.route('/', methods=('GET', 'POST'))
def home(name=None):
if request.method == 'POST':
data = {"templateId": '**templateId**', "customerName": request.form['customerName'], "companyName": request.form["companyName"],
"customerEmail": request.form['customerEmail'], "contractDetails": request.form['contractDetails'], "apikey": '**api-key**'}
# here you will get the documentid
documentId = getdocumentid(data)
def getdocumentid(data):
url = 'https://api.boldsign.com/v1/template/send?templateId=' + \
data["templateId"]
payload = json.dumps({
"title": "Customer Contract Signing",
"message": "Please sign the contract",
"roles": [
{
"roleIndex": 1,
"signerName": data["customerName"],
"signerEmail": data["customerEmail"],
"role": "Manager",
"existingFormFields": [
{
"id": "CustomerName",
"value": data["customerName"]
},
{
"id": "CompanyName",
"value": data["companyName"]
},
{
"id": "CustomerEmail",
"value": data["customerEmail"]
},
{
"id": "ContractDetails",
"value": data["contractDetails"]
}
]
}]})
headers = {
'X-API-KEY': data["apikey"],
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
return response.json()["documentId"]
By utilizing the document ID and customer email address, we can generate an embedded signing link using the BoldSign getEmbeddedSignLink API. This link will be loaded into an iframe within the application, providing a seamless signing experience for the customer. Following is an example of how the Python code can be implemented.
def getsignlink(data):
url = "https://api.boldsign.com/v1/document/getEmbeddedSignLink?documentId=" + \
data["documentId"] + "&signeremail=" + data["customerEmail"] + \
"&redirectUrl=" + data["baseUrl"] + "response/"
headers1 = {
'X-API-KEY': data["apikey"],
}
response = requests.request("GET", url, headers=headers1, data={})
# here you can get the signLink for first signer
return response.json()["signLink"]
<iframe style='width: 100%; height:100%;' src="{{ iframe }}"></iframe>
The next screenshot shows the signing screen embedded in the application.
Once the signing process is successfully completed, you can download the signed document if you wish to save a copy for your records using the download API in BoldSign. The following code snippet illustrates this.
def downloadDocument(data):
url = "https://api.boldsign.com/v1/document/download?documentId=" + \
data["documentId"]
headers1 = {
'X-API-KEY': data["apikey"],
}
response = requests.request("GET", url, headers=headers1, data={})
To learn more about BoldSign APIs, visit our API documentation. Live API demos are also available for several different scenarios. Sample code for popular programming languages is available in this GitHub repo.
If you have questions, you can contact us through our support portal. We are always happy to assist you!
Latest Articles
Demo-Rss
Mandating Signer Authentication When Making Signature Requests via API
How to Send Documents for eSignature with Identity Verification via API