Sign On Mobile

This following guide shows you how to allow signers to use their mobile phones to sign capture signatures.

With OneSpan Sign, you have the ability to sign anywhere, anytime, and on any device. This guide shows you how to sign signatures using your mobile device.

The Code

Below is a sample example code on how to build your Signature object in order to add a mobile capture signature.

Signature mobileSignature = SignatureBuilder.mobileCaptureFor("mail32@mailinator.com")
	    .onPage(0)
	    .atPosition(100, 100)
	    .build();

If you’re not able to add mobile capture signatures, contact support to have this feature turned on in your account.

Running Your Code

Once your signers are ready to sign, they will have the option to either sign using their mobile device or sign directly through your application.

Capture

Get the Code | See this feature in action in our Interactive Demo

With OneSpan Sign, you have the ability to sign anywhere, anytime, and on any device. This guide shows you how to sign signatures using your mobile device.

The Code

Below is a sample example code on how to build your Signature object in order to add a mobile capture signature.

Signature mobileSignature = SignatureBuilder.MobileCaptureFor("mail32@mailinator.com")
	    .OnPage(0)
	    .AtPosition(100, 100)
	    .Build();

If you’re not able to add mobile capture signatures, contact support to have this feature turned on in your account.

Running Your Code

Once your signers are ready to sign, they will have the option to either sign using their mobile device or sign directly through your application.

Capture

Get the Code | See this feature in action in our Interactive Demo

With OneSpan Sign, you have the ability to sign anywhere, anytime, and on any device. This guide shows you how to sign signatures using your mobile device.

The Code

The sample JSON payload below shows you how to create a package with a mobile capture signature on a document.

HTTP Request
POST /api/packages

HTTP Headers
Accept: application/json
Content-Type: multipart/form-data
Authorization: Basic api_key

Request Payload

------WebKitFormBoundary1bNO60n7FqP5WO4t
Content-Disposition: form-data; name="file"; filename="testDocumentExtraction.pdf"
Content-Type: application/pdf

%PDF-1.5
%µµµµ
1 0 obj
<>>>
endobj.... 

------WebKitFormBoundary1bNO60n7FqP5WO4t
Content-Disposition: form-data; name="payload"

{
  "documents": [
    {
      "approvals": [
        {
          "id": "ExampleSignatureId",
          "role": "Signer1",
          "fields": [
            {
              "page": 0,
              "top": 100,
              "subtype": "MOBILE_CAPTURE",
              "height": 50,
              "left": 100,
              "width": 200,
              "type": "SIGNATURE",
              "name": "ExampleSignatureId"
            }
          ],
          "name": ""
        }
      ],
      "id": "sample-contract",
      "name": "Example document"
    }
  ],
  "status": "SENT",
  "type": "PACKAGE",
  "roles": [
    {
      "id": "Signer1",
      "type": "SIGNER",
      "signers": [
        {
          "email": "mail32@mailinator.com",
          "firstName": "John",
          "lastName": "Smith",
          "id": "Signer1"
        }
      ],
      "name": "Signer1"
    }
  ],
  "name": "Mobile Capture Example Package"
}

------WebKitFormBoundary1bNO60n7FqP5WO4t--

For a complete description of each field, take a look at the JSON Properties section below.

Response Payload

{
    "id": "9sKhW-h-qS9m6Ho3zRv3n2a-rkI="
}

If you’re not able to add mobile capture signatures, contact support to have this feature turned on in your account.

Running Your Code

Once your signers are ready to sign, they will have the option to either sign using their mobile device or sign directly through your application.

Capture

Get the Code | See this feature in action in our Interactive Demo

JSON Properties

Property Type Editable Required Default Sample Value(s)
status string Yes No DRAFT DRAFT / SENT / COMPLETED / ARCHIVED / DECLINED / OPTED_OUT / EXPIRED
type string Yes No PACKAGE PACKAGE / TEMPLATE / LAYOUT
name string Yes Yes n/a Mobile Capture Example Package
documents
name string Yes No n/a Example document
id string Yes No n/a sample-contract
approvals
fields
subtype string Yes No n/a FULLNAME / INITIALS / CAPTURE / MOBILE_CAPTURE / LABEL / TEXTFIELD / TEXTAREA / CHECKBOX / DATE / RADIO / LIST
type string Yes No n/a SIGNATURE / INPUT
extract boolean Yes No false true / false
height integer Yes No 50 50 / 100 / 150 …
left integer Yes No 0 50 / 100 / 150 …
page integer Yes No 0 0 / 1 / 2 …
top integer Yes No 0 50 / 100 / 150 …
width integer Yes No 200 50 / 100 / 150 …
role string Yes No n/a Signer1
id string Yes No n/a ExampleSignatureId
roles
id string Yes No n/a Signer1
name string Yes No n/a Signer1
type string Yes No SIGNER SIGNER / SENDER
signers
email string Yes Yes n/a preparer.email@example.com
firstName string Yes Yes n/a John
lastName string Yes Yes n/a Smith
phone string Yes No n/a 514-555-8888
id string Yes No n/a Signer1
company string Yes No n/a Acme Inc.
title string Yes No n/a Managing Director