Third (3rd) Party Integration Guide (HTTP POST Method)

This documentation is only for developers. If you are not a developer with good PHP coding skills then you have no need to read this.

Overview

Integrating a 3rd party payment system or shopping cart with WP PDF Stamper is possible. The integration process can be accomplished in three steps, namely:

1. Generate POST data
2. Send POST data to the POST URL
3. Process the returned data

POST Values

WP PDF Stamper expects a certain set of variables to be sent to it via HTTP POST. These variables are:

Mandatory Variables

• Secret Key:  A Secret API key (you can find this value in the settings menu of this plugin)
• Source File URL: The URL of the source file that needs to be stamped (a copy of the source file will be stamped to keep the source file intact)

Optional Variables

• Customer Name: The name of the customer
• Customer Email: The email address of the customer
• Customer Address: The customer’s address

Return Value

Upon successful processing, WP PDF Stamper will return a plain text message that will have two lines similar to the following:

Success!

http://examle.com/wp-content/plugins/wp-pdf-stamper/stamped-files/test-ebook_4c05fffce4de3.pdf

or

Error!
Secret key is invalid


1. The first line is an indication of success or error
2. The second line is the result. In the event of success, it will contain the URL of the stamped file (this is a copy of the source file but stamped with the appropriate information)

Sample PHP Code

The following link has a sample PHP code that shows how easy it is to integrate with WP PDF Stamper.

• Sample Integration PHP Code

1. Burt says:

   October 9, 2010 at 9:43 am

   Hi Admin,

   my boss purchased this product and im his developer. We are selling ebooks, and we use this tool to stamp the pdf. My problem is when im using this PHP Integration then encrypting 3 files in a consecutive way, sometimes one of the file among 3 was not stamped successfully. Please help.
2. admin says:

   October 10, 2010 at 2:14 am

   Hi Burt, If you are trying to stamp 3 large PDF files then please make sure that the PHP script execution timeout value is big enough to finish the job otherwise the server will kill the script before it completes. You can check the PHP script execution timeout value in the PHP.ini file of your server and modify the value as necessary.
3. Burt says:

   October 11, 2010 at 3:15 pm

   Thank you admin. your reply will be a big help for our business.
4. Constantin says:

   February 26, 2011 at 5:21 pm

   I intend to buy PDF Stamper plugin and use it on my clickbank site. Is there any chances that a non-tech person (like me) to be able to integrate it with clickbank.

   Will be possible some advice (if nedeed) from you in this regard?

   Best regards,
   Constantin
5. admin says:

   February 28, 2011 at 2:32 am

   The issue with clickbank is that it doesn’t send the address back to the site after the transaction. It only sends the name and the email address of the customer so PDF stamper will be able to stamp those details only (customer name and email address)