PayPal Pro gateway for WordPress

ZetaPrints web-to-print system has a choice of PayPal hosted payments page or a custom payments provider using an external gateway. We implemented an open source WordPress plugin for taking payment via PayPal Pro.

This plugin is in Beta, meaning it is still work in progress and may contain faults. Please, report any problems to support@zetaprints.com.

paypalpro

web-to-print payment gateway

Requirements

You need to have a website running WordPress. ZetaPrints web-to-print software provides only online ordering functionality and it’s likely you have another “about us” type of website for your company. This plugin can only be used with such websites running on WordPress.

Taking customer credit card details requires a secure connection. You need to purchase and install an SSL certificate for the site where the plugin will be installed. The payments page must be accessible via HTTPS protocol only.

Installation

Warning: it is better to use help of someone familiar with WordPress administration.

  1. Download the plugin from its project home.
  2. Log in to your WordPress website as an admin and nvaigate to Plugins/Add New page.
  3. Upload the plugin to your WordPress site and activate it.

You may need to de-activate and uninstall the plugin if you see any error messages or your website may become un-operational.

Configuration

The plugin needs to be configured at both ends: in WordPress and in your ZetaPrints web-to-print portal. ZetaPrints configuration is described in Payment gateways help post.

To configure the plugin, go to your WordPress admin section and navigate to Settings/PayPalPro gateway page.

  • Enter PayPal Pro parameters from PayPal website.
  • Enter your web-to-print API key into ZetaPrints API key text box.
  • Enter email details for failure reports.
  • Click Update settings button.

Payments page creation

Create a post or a page to host the payments form. Format the page the way you want and insert shortcode [paypalpro] where you want the payments form to appear. Simply enter it as it appears here, in square brackets: [paypalpro]. WordPress will substitute the shortcode with a proper form generated by the plugin.

Publish the page/post and use the absolute URL (permalink, including https:// prefix) as your gateway URL in ZetaPrints configuration. If the URL has http:// prefix you need to change it to https://.

You can modify the look of the form by editing plugin’s CSS in paypal.css file. Do not do this unless you know where to find the file. Consider getting professional assistance for this task.

How the plugin works

  • A user is redirected from your web-to-print portal to the payments page. Necessary transaction data is passed on with the request.
  • The user enters credit card details into the form on your WordPress site.
  • The plugin sends the data to PayPal. The result can be success, pending, declined, etc.
  • If PayPal’s response is negative the user is asked to correct the input and submit again or cancel and return to your web-to-print portal.
  • If PayPal’s response is positive the plugin sends a specially crafted request to ZetaPrints with transaction ID as a confirmation and redirects the user back to your web-to-print portal.

The confirmation request from the plugin to ZetaPrints is a weak link. If it fails the order remains unpaid in ZetaPrints database. You should get an automated email sent by the plugin for any failures. More on the interaction is in plugin’s documentation.