sharpResponse - Documentation - Create and Edit new package

This article describes how to create new PDF package. Test encryption and tampering functionality of the PDF files you are including in the package. Read the next manual article Edit Properties of the Package for detailed description of how to configure your package correctly. Create new Package Editing and Configuring Package Properties Configure PDF sending properties Respond to PayPal Instant Payment Notification Respond to emails Mailing Options Sending properties

Description

Create new Package

To create new package click Create New Package button in the tool bar or Select Create New Package from the menu. New package windows will open. In this window you can define initial PDF files that will be included into the package.

Click Browse button to select the folder which contains PDF files you want to include. The pane below will display all PDF files that can be rendered for secure tampering. Here you can delete PDF that are not needed to be included into the package, view PDF using Adobe Reader and test the functionality of the PDF file. To test whether the PDF file can be securely tampered and password protected, select PDF file from the list of all files and click Test Button.

The PDF Compiler will be discussed in more details in Edit Package Properties article. The package title is a unique name for the package, this will not be visible to a recipient at any point. The name is simply for local identification of the package. You can define any name you want. Once the name has been defined click OK button to proceed to the detailed package configuration

Here we discuss how to correctly configure newly created or existing package. The configuration includes basic properties that you need to consider to allow the package to be sent to the right recipient with the right functionality. These properties are – what files are sent, how they are protected, tampered, whether you want them to be zipped, define when this packages is sent in response to received email or PayPal Instant Payment Notification.

It is important to make sure that the configuration of the package is correctly defined, otherwise the package might not be sent at the right time to the right person. It is a good practice to test whether the package is sent properly by sending yourself an email or originating dummy IPN (dummy Instant Payment Notification is discussed in Quick Steps to Test Functionality manual article) If you have just created an new package, the Package Config window will be opened automatically after you clicked OK button in New Package window. Or if you want to edit properties of the existing package, select the package name from the list in the main form and click Config button below the list.

In this window you will see all PDF and other included files of the package in the left hand side pane. To add new file click Add New button, select the file and click OK. To delete file from the package click Delete.

It is worth noting that you can configure the whole package or single PDF individually. So that when configuration exists for the whole package, this configuration applies to PDF that do not have sending properties defined, otherwise the PDF’s individual configuration is applied.

The PDF Config tab displays text based description of the current configuration of the package, which describes all the defined properties of the PDF to be sent.

To configure PDF individually, select the PDF file from the list on the left and click Config button.

Encryption means that the PDF will be encrypted with 40bit or 128bit symmetric encryption algorithm and is guaranteed to be protected from extracting text and any other content from the PDF.

You can define password to be unique for every single email or IPN you have received. For example, if PDF is set to have senders name as a password (like in the screenshot above) and John Becker send you a PayPal payment, the PDF that will be sent back to John Becker is protected by password John Becker.

You can also defined a unique permissions for PDFs, such as you can prevent people from printing the PDF, prevent copying the content of the PDF (by clicking CTR+C) or using screen dump to extract the content. These permissions when used with the password protected encryption guarantee authenticity of the document you are sending and there is no software or cracks exist that can break through this security options.

Click OK once you have finished with the Compiler config

To configure the package to be sent in response to a specific PayPal payment, click PayPal tab. Here you can define all item names for which you expect to receive PayPal payment. For example in the screen shot before, we have defined three possible item names, any of the payments for these items will trigger package to be sent to the payer.

The package can also be sent as a response to an email you receive. This method can also be used to send packages to PayPal, Nochex, PPPay or any other money handling service, simply by parsing emails that the service provider send you when payment is received. In order to explain how to configure auto-mailing option we simply take an example of PayPal Instant Payment Notification email, which is listed below. We have highlighted the words we are looking for in order to initiate the package sending.

Here we simply add so-called rules of how email is parsed in order to validated whether package should be sent to the person originated the payment. Think of these settings as a search parameters for the email, i.e. when email is received the search parameters are applied to determine whether it is necessary to send the package to the email sender. Each line in the rule set represent AND conjunction, so the above would be read like.

If subject contains Instant Payment Notification and Body Text contain Some Person and Body Text contains render graphic card processes or capture graphic card processes and Body Text contains eBook and Body Text contains PayPal then the package will be sent to the payment originator.

Note that in order to use OR conjunction you have to define all ORs within one rule line and not overlap the meaning with the AND conjunctions on the next rule line. This can be quite tricky, but if you think of it as the example above, constructing a first order logic sentence then it all starts making sense.

Mailing options allow you to define how and what text will be sent with the package, what subject will the email carry. The e-mail body text is dynamically modifiable (sorry for the invented word), meaning that the content of the message may vary based on the original email or Instant payment notification, or in fact the configuration of the package itself. Lets look at some real example,

The replay message and subject can contain modifiable fields which are encapsulated into [%fieldname] format. The insert drop down box allows you select the predefined ones from the list, they are self explanatory. It is highly recommended to include the file list information to ensure the message passes through SPAM filters. Saying that, the fact that the email contains encrypted PDF and providing the fact you have listed all files the emails any decent SPAM filter will allow this email to pass through since no spammers use such a technique to deliver get-rich-schemes offers to your mailbox.

Scan for DEAMON MAIL return, allow the program to start process that tracks the delivery of the email. This trigger simply monitors emails headers from MAIL DEAMONS, which tend to respond to undelivered emails. The DEAMON tracker is bound to the email you have sent, if the DEAMON responds to the email you have sent, stating that the email box does not exist, sharpResponce will warn you of that automatically, and if mailbox is simply full, not functional or unreachable the program will attempt to deliver the message next time round.

Here you can specify whether you want the all files including all PDF files to be zipped prior to sending. Hence the recipient will receive one ZIP file that contains all files.

When finished configuring your package, simply click Apply to save changes.

<< Back | Next >>

Home       About Us       Support       Services       Contacts