Pdftools SDK license management

Learn how to manage the Pdftools SDK license keys. The information on this page applies to legacy and page-based licenses. The Pdftools SDK also includes the Toolbox add-on that can be used with the same license key.

Request trial or full license

You can use the Pdftools SDK and the SDK Shell Tool without a license key with watermarked results. To get a full license and remove the watermarks, or to evaluate the Toolbox add-on:

1. Reach out to the sales team through the Contact page and mark the Pdftools SDK as the product of your interest for a trial license.

Find the license key

To find and copy a license key:

1. Log in to My PDF Tools Portal.
2. Click Licenses & Kits.
3. Click Pdftools SDK.
4. In the License section, click the LICENSE button to reveal the license key, and then click COPY.

Use the license key in the same format as you copied it. Include the less-than (<) and greater-than (>) signs.

Trial license

The Pdftools SDK and Pdftools SDK Shell Tool don't require a trial license key, but the Toolbox add-on requires it. You can use the same license key for Pdftools SDK, Pdftools Shell Tool, and the Toolbox add-on.

SDK	To try the SDK	Output files	Get a license key
Pdftools SDK	No trial license key is needed.	Watermarked results without a license key.	To remove the watermark from the output files, contact the sales team through the Contact page.
Pdftools SDK Shell Tool
Toolbox add-on	Obtain a license key to try the SDK.	Obtain a license key to use the SDK.	To try the SDK, contact sales team through the Contact page.

Licensing credit count

Credit-based pricing charges a page credit for each operation performed on a document page.

A page credit is used for:

• Each page of a document.
• Each operation applied to that page.

Review the following table for more information about the credit count in the Pdftools SDK and the Toolbox-add-on for specific operations:

Operation	Page credits used
Annotate	1
Add or remove content	1
Add and fill form fields	1
Archive PDF/A-2	2
Archive PDF/A-3	2
Archive PDF/A-1	2
Redact	1
Compress and optimize	1
Convert	1
Create layout for printing	1
Extract	1
Embed e-invoice	1
Generate PDFs	1
Manage metadata	1
Merge and split PDFs	1
Archive TIFF	1
Sign and secure	1
Validate	1

Only PDF to PDF/A conversion is charged at 2 page credits per operation; all other operations cost 1 page credit.

Operations

An operation is any action performed on a document using the Pdftools SDK. Common operations include:

• File conversions: Converting files to or from PDF (for example, TIFF to PDF, PDF to image).
• Compressing or optimizing PDFs.
• Merging files or extracting pages, adding signatures, encrypting, or annotating PDFs.

Each time you apply an operation to one or more pages, page credits are charged based on each page affected by the operation. Pages that are not affected by the operation are not charged. For example, if you have a 10-page document and only use the extract operation on five pages, only 5 page credits are used.

Calculating credits

To determine how many page credits you'll need for your tasks using the Pdftools SDK, follow this formula:

Number of pages x number of operations = total page credits used

For example:

• Three-page PDF, one operation: Converting a three-page TIFF to PDF requires 3 page credits (1 per page).
• Three-page PDF, two operations: Converting a three-page PDF and then compressing it requires 6 page credits (3 pages x 2 operations).
• Three-page PDF, PDF/A conversion: Converting a three-page PDF to PDF/A requires 6 page credits (3 pages x 2 page credits).

Page credits are calculated for every operation applied. If multiple actions are performed on a file, page credits are consumed for each operation. For example:

• Four pages, one operation: Signing four individual pages of PDF costs 4 page credits (4 pages x 1 operation).
• Four pages, two operations: Converting and compressing a four-page PDF costs 8 page credits (4 pages x 2 operations).
• Four pages, three operations: Converting, compressing, and adding a watermark to a four-page PDF costs 12 page credits (4 pages x 3 operations).

License key validation

License keys are validated using the Pdftools Licensing Service. The SDK connects to the Pdftools Licensing Service to provide information on usage and retrieve new licensing parameters after processing a document.

The Pdftools Licensing Service collects the following statistics and information:

• License number
• Pdftools SDK functions used and the number of pages processed

For information on managing your license key with the Pdftools Licensing Service, see Pdftools Licensing Service.

Activate the Pdftools SDK license

Learn how to activate a license key for the Pdftools SDK. Review the appropriate link for your programming language:

• Initialize the SDK C
• Initialize the SDK Java
• Initialize the SDK .NET
• Initialize the SDK Python
• Initialize the SDK Other languages and frameworks

Activate the Toolbox add-on license

Learn how to activate a license key for the Toolbox add-on. Review the appropriate link for your programming language:

• Initialize the SDK C
• Initialize the SDK Java
• Initialize the SDK .NET

Use Pdftools SDK Shell Tool license

Learn how to use the Pdftools SDK Shell Tool license key:

• Use of license key

Default license configuration

By default, when the Pdftools SDK is initialized, it attempts to connect to the Pdftools Licensing Service directly. This requires an internet connection to the default licensing service URL:

https://licensing.pdf-tools.com/api/v1/licenses/

caution

By default, if the Pdftools SDK cannot connect to the licensing service URL, the SDK initialization fails.

Use the Licensing Gateway

Use the Licensing Gateway Service if the Pdftools SDK needs to operate without a direct connection to the Pdftools Licensing Service.

To configure the SDK to use the Licensing Gateway Service, set the LicensingService property of the Sdk class before calling Sdk.Initialize.

.NET

static void Main(string[] args)
{
    try
    {
        // Set the URL to the Licensing Gateway Service.
        Sdk.LicensingService = new Uri("http://my.gateway.com:9999");

        // Set and check license key. If the license key is not valid, an exception is thrown.
        Sdk.Initialize("$LicenseKey$");

Java

public static void main(String[] args)
{
    try
    {
        // Set the URL to the Licensing Gateway Service.
        Sdk.setLicensingService(new java.net.URI("http://my.gateway.com:9999"));

        // Set and check license key. If the license key is not valid, an exception is thrown.
        Sdk.initialize("$LicenseKey$");

note

More information about the LicensingService property is available in the SDK documentation for .NET and Java.

Check the license status

When the Pdftools SDK is successfully initialized, check your license status by accessing the LicenseInfoSnapshot property of the SDK class. This property provides the following information about the current license:

• IsValid: License validity.
• ExpirationDate: The date and time when the license expires.
• RemainingPages: The number of pages available to be processed, based on the license agreement.
• Overconsumption: The number of pages available to be processed, before the SDK stops functioning.

If the RemainingPages value reaches zero, the Pdftools SDK provides a limited number of Overconsumption pages. The Overconsumption pages give you time to update your license agreement without disrupting your business processes.

caution

If both the RemainingPages and Overconsumption values reach zero, the Pdftools SDK stops functioning until the licensing service is updated with new license information.

note

More information about the LicenseInfoSnapshot property is available in the SDK documentation for .NET and Java.