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:
- 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:
- Log in to My PDF Tools Portal.
- Click Licenses & Kits.
- Click Pdftools SDK.
- 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:
Use Pdftools SDK Shell Tool license
Learn how to use the Pdftools SDK Shell Tool 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/
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
- Java
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$");
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$");
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.
If both the RemainingPages
and Overconsumption
values reach zero, the Pdftools SDK stops functioning until the licensing service is updated with new license information.