Documentation
ASP.NET PayPal Control for Website Payments Standard / Generating Encrypted Payment Buttons

Generating your certificates using the wizard

If you have visited the page for generating Encrypted Payment Buttons, then you already know that you need to generate your PKCS12 certificate file and public certificate file (*.pem) in order to generate Encrypted Payment buttons.

If you are using ASP.NET MVC framework, then, you will find a stand alone portable certificate generation tool available from your Start Menu -> Program Files -> ASP.NET PayPal Control ... -> Certificate Generator


certificate_generator_tool


But if you are using Web Form, then, you will find the Certificate Generator tool built in to all PayPal buttons and you can invoke that tool from the design time smart tag wizard by following the provided steps:
  1. From the smart tag of a BuyNow button, check the option 'Generate Encrypted Button'. Once you checked that option, a link will be shown named 'Settings and Automation Wizard for EWP'. step 1
  2. Click that link 'Settings and Automation Wizard for EWP', the Encrypted Button generation wizard will be shown up. In that dialog, click the "Generate Certificates Now" button as shown in the following screen shot: ewp Button For Generate Cert
  3. Once this button is clicked, the Certificate Generation window will appear. certificate Generation Wizard This tool is similar to the stand alone tool we introduce you. The following instructions are applicable to both Web Form users and MVC users as the usage for the tool is same.
  1. Now, please fill up the form shown in the tool and it is very self explanatory and clear. Every text-box is backed up with a help button. Clicking the help button will pop up a message box with the explanation of that field. Please fill up at least your Company Name, Your Name, Your Email Address. The 'company name' and your 'name' must match with the 'company name' and your 'name' that you have in your PayPal account. Otherwise, PayPal will refuse to accept the encrypted button payment with the error "The merchant does not have business or premier account.".
  2. Then, provide a file path for saving your generated public certificate file (*.pem) which will be uploaded to PayPal for getting your Certificate ID. Also provide the file path for saving the generated PKCS12 file (*.p12). Please note: You should save these files within the App_Data folder of your web application. Because these folder are secured and the confidential files kept in this folder can not be downloaded by any client browser. Once you provide the file paths, the information will be passed back to the first window where credentials are asked. Finally provide a password for protecting your PKCS12 file. This information will also be passed back to the first window.
  3. Click "Generate Certificates Now" button.The certificates will be generated using OpenSSL command line utility in the background. certificate Generation
  4. Go Back to generating Encrypted Payment Button page.


Some facts about OpenSSL:

At this point, you should know that, the certificates will be generated using OpenSSL command line utility but you wont have to worry about this at all. If your computer already has this software installed, it will find out and call the OpenSSL internally and generate the certificates for you without letting you learning any commands for this command line utility. If this wizard cannot find the OpenSSL installed, it will show you the following option box:

not Found Open SSLWindow

If you have this software already downloaded but did not install yet, you can provide the path of the installer and choose the first option and click Ok. In that case, the wizard will start installing the software without requiring your interruption. Once OpenSSL is installed, the wizard will generate the certificates using the help of OpenSSL.

If you do not have the installer for OpenSSL, no need to worry, just provide a folder path where you want the wizard download OpenSSL for you. Once you click 'Yes', the wizard will show the download progress window and let you wait for the OpenSSL file to be downloaded as shown in the following screen shot:

Open SSLDownloading Window

OpenSSL is only about 6MB and it downloads very fast. Once it is downloaded, the wizard already knows the location of the installer, so it will start installing the software without requiring your interruption. Once OpenSSL is installed, the wizard will generate the certificates.

If your computer has these DLL files : C:\Windows\system32\ssleay32.dll, C:\Windows\system32\libeay32.dll, C:\Windows\system32\libssl32.dll then these files will need to be overwritten by OpenSSL installer, otherwise OpenSSL will not be able to generate certificates for you. So, when the wizard calls the installer, if the installer finds these dll file in your system, it will show you an warning dialog box with the message of overwriting those System DLL files. However, this wizard will give you an option to back up those files before they are overwritten. The warning dialog of the wizard will ask you if you want to back up those system DLL files or not. If you choose 'Yes', the wizard will ask you the folder path for backing up the files. As shown in the following screen shot:

warning Overriting System DLL




Last updated on 4 July 2012, Wednesday, 11:55:39 PM