Signature Capture for Android

About
What others say about our product
Pricing
Developer License instructions
Full version instructions
- Integration with Android application
- Integration with web site
Frequently asked questions
Looking for a stylus?
Privacy Policy

About

Electronic signature capture library/app for Android. Sign by touching the screen.

Start as a normal app for demo/trial. In this mode the app requires internet connection and saves up to 5 signatures per week.

The app can be downloaded from the Google Play Store or directly from our server here.
The latest backward compatible version targeting API level 29 is available here.

Download QR-Code

Signature Capture

Developer: Binary Solutions

Price: Free

For PDF signing check out our free application Fill and Sign PDF Forms.

Missing feature?

If you are an Android developer and you would like to request a new feature to be implemented, you can do it here.

Need support?

In case you need support with library integration and usage, you can always contact us at the email address here.

What others say about our product

Excellent product for capturing a signature. My company has integrated it into our proof-of-delivery mobile application and it has always worked great. Exceptional customer service!

Andy VankempenSoftware Engineer at Jump Technologies, Inc.–LinkedIn Profile

Great product that allowed us to add functionality to a new site we’re developing. Responsive and appropriate support. Simple solid solution that works well – don’t just take my word for it, download it for free and see for yourself!

Tom WolfeMedia Design Technician at Airon HVAC and Control Ltd.–LinkedIn Profile

I started using this product over a year ago to integrate a signature capture software to my web based service engine using Android phones. Binary Solutions was the only company that was able to give me a working product that works seamlessly. Over time we have grown our product into an Android application, and they were able to give us more control and flexibility with signature captures. It took minutes to implement and we’ve captured over 1000 signatures since we started using it.

Jon BaileyChief Technology Officer at POSabilities, Inc.–LinkedIn Profile

We have integrated this signature capture component into our multi-platform mobile app environment. A good number of our customers have used it in the apps they have built for their users and all have been very happy with it.

Ian BowlesCEO at Seregon Solutions Inc.–LinkedIn Profile

Pricing

Demo/Trial version
Free
APK file
signed by Binary Solutions
Data connection
required
Unlimited number of devices
Max. 5 signatures per week
Free updates
* yearly subscription, corresponds
approx. to $12.93 USD
Download

Full version
EUR 12€*
APK file
signed by Binary Solutions
Data connection required
only during the license activation
Valid for a single device/user
Unlimited number of signatures
Free updates
* yearly subscription, corresponds
approx. to $12.93 USD
BUY NOW

Developer License
EUR 500€*
AAR files for embedding in a
single Android project (application)
Data connection
not required
Unlimited number of devices
Unlimited number of signatures
40% discount for upgraded releases
* one time payment, corresponds
approx. to $539 USD
CONTACT US NOW

Developer License instructions

We strongly advice that you use the free version during the application development and testing. Once you are done, switching to Developer License is an easy process.

Integration instructions, usage instructions and license information for Developer License are available in sample package here. Please go through the package before you decide to make a purchase.

Sample package does not contain AAR files. You get those after the purchase.

Full version instructions

Integration with Android application

If you want to use Signature Capture from your own Android application, all you have to do is call the right activity and pass it desired parameters. Your application will receive the notification when the file with captured signature is ready for reading. Code snippets follow:

Calling the Signature Capture activity

Intent intent = new Intent("biz.binarysolutions.signature.CAPTURE");

String keyCode            = "biz.binarysolutions.signature.ActivationCode";
String keyFileName        = "biz.binarysolutions.signature.FileName";
String keyTitle           = "biz.binarysolutions.signature.Title";
String keyStrokeWidth     = "biz.binarysolutions.signature.StrokeWidth";
String keyStrokeColor     = "biz.binarysolutions.signature.StrokeColor";
String keyCrop            = "biz.binarysolutions.signature.Crop";
String keyWidth           = "biz.binarysolutions.signature.Width";
String keyHeight          = "biz.binarysolutions.signature.Height";
String keyBackgroundColor = "biz.binarysolutions.signature.BackgroundColor";
String keyBackgroundImage = "biz.binarysolutions.signature.BackgroundImage";
String keyKeepSignature   = "biz.binarysolutions.signature.KeepSignature";

String  code            = "";             // your purchase transaction id
String  fileName        = "";             // set the file name (see important notes bellow!)
String  title           = "";             // optional, default is 'Signature Capture'
int     strokeWidth     = 10;             // optional, default is 8
String  strokeColor     = "FF0000FF";     // optional, default is BLACK (FF000000)
boolean crop            = false;          // optional, default is true
String  backgroundColor = "FF00FF00";     // optional, default is fully transparent
String  backgroundImage =                 // optional, default is none
            "http://binarysolutions.biz/logo.png";

// allowed units: px, dp, dip, sp, pt, mm, in
String width  = "300dp";                  // optional, default is max
String height = "100dp";                  // same as above

/* The following parameter is available only when targeting API level 30 or above.
   If set to true, the signature file is persisted in Signature Capture's directory.
*/
boolean keepSignature = true;               // optional, default is false

intent.putExtra(keyCode, code);
intent.putExtra(keyFileName, fileName);
intent.putExtra(keyTitle, title);
intent.putExtra(keyStrokeWidth, strokeWidth);
intent.putExtra(keyStrokeColor, strokeColor);
intent.putExtra(keyCrop, crop);
intent.putExtra(keyWidth, width);
intent.putExtra(keyHeight, height);
intent.putExtra(keyBackgroundColor, backgroundColor);
intent.putExtra(keyBackgroundImage, backgroundImage);
intent.putExtra(keyKeepSignature, keepSignature);

intent.setComponent(
    new ComponentName(
        "biz.binarysolutions.signature",
        "biz.binarysolutions.signature.Capture"
    )
);

startActivityForResult(intent, CAPTURE_REQUEST_CODE);

Important notes regarding the file name

If you are using Signature Capture that is targeting API 30 or above

You have to provide the file name, without path, including the extension (png).

If you are using Signature Capture that is targeting API 29

You have to provide the full path name, including the extension (png). The file itself does not have to exist but all directories on the path have to. The file has to have global write permissions. This means that you will (most likely) store it on SD Card. Use one of the following methods in order to obtain writable storage:

Environment.getExternalStorageDirectory()
Environment.getExternalStoragePublicDirectory()

All file name restrictions that exist for Android (Linux) file system are valid here too.

Receiving the result (target API 30 or above)


@Override
public void onActivityResult(int request, int result, Intent intent) {
	super.onActivityResult(request, result, intent);

	if (request != CAPTURE_REQUEST_CODE || intent == null) {
		return;
	}

	if (result == RESULT_OK) {
		try {
			FileDescriptor descriptor =
				getContentResolver().openFileDescriptor(intent.getData(), "r")
					.getFileDescriptor();

			// read file descriptor and do with bitmap whatever you like

		} catch (NameNotFoundException e) {
			e.printStackTrace();
		}
	} else {
		String errorMessage = intent.getStringExtra("biz.binarysolutions.signature.ErrorMessage");
		// handle the error
	}
}

Receiving the result (target API 29 or bellow)


@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);

    if (requestCode != CAPTURE_REQUEST_CODE) {
        return;
    }

    if (resultCode == RESULT_OK) {

        String fileName = ""; // the same file name as above
        Bitmap bitmap   = BitmapFactory.decodeFile(fileName);

        // do with bitmap whatever you like

    } else {
        String errorMessage = data.getStringExtra("biz.binarysolutions.signature.ErrorMessage");
        // handle the error
    }
}

If you would like to see the full working example, you can take a look at our application called Signature Share. It’s source code is released under the Apache License 2.0 and it is available here:
Signature Share (targeting API level 29 and bellow),
Signature Share (targeting API level 30 and above).

Integration with Web site

You can also start Signature Capture from your web site shown in Android browser. In this case captured signature will not be saved on a device but uploaded to your server instead. Clickable link that will start Signature Capture activity is the following:

<a href="
    intent:#Intent;
    action=biz.binarysolutions.signature.CAPTURE;
    S.biz.binarysolutions.signature.Title=Signature%20Capture;
    i.biz.binarysolutions.signature.StrokeWidth=7;
    S.biz.binarysolutions.signature.StrokeColor=FF0000FF;
    S.biz.binarysolutions.signature.BackgroundColor=9900FF00;
    S.biz.binarysolutions.signature.BackgroundImage=
        http%3A%2F%2Fbinarysolutions.biz%2Flogo.png;
    B.biz.binarysolutions.signature.Crop=false;
    S.biz.binarysolutions.signature.Width=300dp;
    S.biz.binarysolutions.signature.Height=200dp;
    S.biz.binarysolutions.signature.ActivationCode=;
    S.biz.binarysolutions.signature.UploadURL=
        http%3A%2F%2Fwww.example.com%2Freceiver_script;
    S.biz.binarysolutions.signature.SuccessURL=
        http%3A%2F%2Fwww.example.com%2Fsuccess.html;
    S.biz.binarysolutions.signature.FailureURL=
        http%3A%2F%2Fwww.example.com%2Ffailure.html;
    end">Click to capture signature!</a>

‘href’ value has to be in a single line! Example here is in multiple lines in order to fit on screen and be more clear.
‘S.biz.binarysolutions.signature.Title=;’ part is optional, if it is set it has to be encoded, default value is ‘Signature Capture’.
‘i.biz.binarysolutions.signature.StrokeWidth=10;’ part is optional, default value is 8.
‘S.biz.binarysolutions.signature.StrokeColor=FF0000FF;’ part is optional, default value is FF000000.
‘S.biz.binarysolutions.signature.BackgroundColor=FF00FF00;’ part is optional, default value is 00000000 (fully transparent).
‘BackgroundImage’ part is optional, default value is none. If it is given, it has to be properly encoded URL of the background image, i.e. watermark.
‘B.biz.binarysolutions.signature.Crop=false;’ part is optional, default value is true.
‘S.biz.binarysolutions.signature.Width’ and ‘S.biz.binarysolutions.signature.Height’ parts are optional, they represent the capture window width and height, respectively. Default values are max screen dimensions. Allowed units are: px, dp, dip, sp, pt, mm and in.
Add your invoice id (if you have purchased the app via FastSpring) or transaction id (if you have purchased the app via PayPal) right after ‘ActivationCode=’ and before the first next ‘;’.
‘UploadURL’ has to point to your server-side script and it has to be properly encoded. Spaces have to be encoded with ‘+’ instead of ‘%20’. In this example, url of the script is http://www.example.com/receiver_script
Look below for more info on handling the uploaded image on server side.
‘SuccessURL’ and ‘FailureURL’ are optional parameters. Depending on the success of signature upload, application user will be directed to one of these two URL’s afterwards.

For reference and URL encoding tools, check the HTML URL Encoding Reference (Thanks to Vu Nguyen).

The following snippet demonstrates how to fetch the file on server side in PHP:


<?php 
$newFilePath = "./signature.png";
file_put_contents($newFilePath, file_get_contents('php://input'));
?>

The following snippet demonstrates how to fetch the file on server side in ASP.NET (code sample provided by Vu Nguyen):

Protected Sub Page_Load(ByVal sender As Object,
    ByVal e As System.EventArgs) Handles Me.Load

    Dim filePath = "" 'Set your file path and name here'

    Using bmp As New System.Drawing.Bitmap(Request.InputStream)
        bmp.Save(filePath, System.Drawing.Imaging.ImageFormat.Png)
    End Using

End Sub

FAQ

What is my activation code/license key?

If you have made a purchase via PayPal, use your Transaction ID as an Activation code. In case you have made your purchase through Fastspring, enter Invoice ID instead. One of those two numbers is available in your email purchase statement.

How do I activate the license with the key that I already have?

In order to activate your license, follow the next steps:

1. start the application
2. click on menu button (three dots in upper right corner)
3. click on ‘Activate Full Version’ menu item
4. click on the button ‘Enter the activation code’
5. in ‘Activate’ dialog enter your activation code.

Please type in your activation code as it is, with capital letters and dashes. Copy-pasting sometimes inserts extra white space characters and it doesn’t work.

My activation code does not work. What should I do?

Please type in your activation code as it is, with capital letters and dashes. Copy-pasting sometimes inserts extra white space characters and it doesn’t work.

Activation also fails if the activation code has been used earlier on some other device. In this case an automated email is sent to address that was used during the purchase. If this is the case, please check your spam folder.

How to transfer a license from one device to an another?

You can just type in your activation code on a new device. If there are unassigned licenses left, everything will work as usual. In case there are no licenses left, the activation will fail but an automated email will be sent to email address that was used during the purchase. This mail will contain a list of web links that, when opened, will ‘clear’ a license that is assigned to a particular device.

Devices are identified by ID and license activation timestamp. You can find out device ID if you start Signature Capture application, press Menu and then About.

A small note: these ID’s are modified by Android system when factory reset is performed.

Are there any purchase discounts?

Yes, for Standard License there is a 10% discount for purchases of 100 and more licenses. For Developer License there is a 40% discount for version upgrades.

How can I know how many unused licenses I have left?

If you want to check the number of unused licenses for your activation code, you can get the list of Device ID’s that are in use at the following URL:

https://signature.x.binarysolutions.biz/license/listDeviceIDs?activationCode=YOUR_ACTIVATION_CODE

Use the following URL if you want to check the number of unused licenses for email address that was used during the purchase:

https://signature.x.binarysolutions.biz/license/listDeviceIDs?payerEmail=YOUR_EMAIL_ADDRESS

Unused licenses will be marked with ‘(free)’.

When started from web, after every capture is a new tab in the browser opened. Is there something I can do to stop this?

We have done some tests trying to limit the number of tabs, but existing options do not provide the consistent solution. This really
depends on the version of Android OS and the browser that is used.

Perhaps you could do the following: leave the success URL empty. This way you will be returned to your existing web page. In case you would like the page to get reloaded (and it does not get reloaded automatically) you could do that with some javascript.

How can I access my invoice for purchase made via Fastspring?

Your invoice is always available at the following URL:

https://sites.fastspring.com/binarysolutions/order/invoice/BINxxxxxx-xxxx-xxxxx

Replace the last part of the URL with your actual activation code.

I have saved a signature but the image is all black, why is that so?

Captured signature is placed on transparent background. Some image viewers that are running on Android devices show transparent background as black, and that’s why you see nothing. If you transfer the image to your PC, or open it with some other viewer, you’ll see that it’s captured correctly. Additionally, you can change background and stroke color in app settings.