Plugin - PagSeguro (Create custom order forms)

RSForm!Pro PagSeguro Payment Plugin

The RSForm!Pro PagSeguro Payment Integration Plugin allows you to add a new payment method to the existing Payment Package of RSForm!Pro.

Documentation Please make sure you install the Payment Package plugin first.Download the plugin
Downloading and Installing the plugin
Download

You can download the plugin by logging with your purchase user, then head to Downloads > My Downloads > RSForm!Pro - view all plugins and modules > RSForm!Pro Files > Plugins > "PagSeguro Plugin for Joomla! 3.x".


Install

In the backend of your Joomla! installation go to the Extensions > Install/Uninstall page, and install the plugin. Next thing is to publish the plugin, to do this go to Extensions > Plug-in Manager, search for the "RSForm! Pro - PagSeguro" plugin and publish it.


Configuring the plugin

Configuring PagSeguro payment gateway can be done from Components >> RSForm!Pro >> Configuration >> PagSeguro tab:


  • PagSeguro E-mail: the email address you have used when creating your PagSeguro account
  • PagSeguro Token: the token you generated for your PagSeguro account
  • Live Mode: Yes / No - set to No in order to enable the testing mode
  • Lightbox Mode: Yes / No - set to Yes in order to enable the lightbox mode which will open a modal window to complete the payment instead of being redirected to PagSeguro

How to use the PagSeguro plugin

After configuring the PagSeguro parameters from Components >> RSForm!Pro >> Configuration >> PagSeguro tab, there are some additional steps that needs to be taken in order the payment process to work properly:

Making sure the form is sent to the payment processor

The payment details will only be sent to the PagSeguro payment processor if the user selects PagSeguro from the "Choose Payment" field before submitting the form.

The "Choose Payment" field is used in order to allow the users to choose their payment method. It displays the payment methods added to the form in either a Dropdown or Radio Group. It can be shown on the form (allowing the user to select his preferred payment method) or not (forcing the user to pay using the default payment method).

If you are using a single payment method and you need to hide the Choose payment field, this can be achieved by editing the field and setting to "No" the "Show in front-end?" option within the "Attributes" tab.

In order the PagSeguro payment method to be available within the Choose payment field, the PagSeguro payment field needs to be added in form.

Adding costs

In order to receive funds using RSForm!Pro and PagSeguro payment plugin, your form needs to include a cost. In order to add costs to your form you can use any of the following fields:

  • Single Product - Adds a single product to the form. For this type of field you can set up a caption, description and a price.
  • Multiple Products - Adds the ability to display multiple products to be purchased either in a Dropdown or a Checkbox. Its items need to be specified in the following manner: price | label (ex: 15 | T-shirt)
  • Donation - Allows the user to type in the amount to be paid inside a standard Textbox.
  • Total - This field is used alongside the Donation, Single and Multiple Products fields. It calculates the total price to be paid.
 
Mapping form information to PagSeguro

You can pass the following information directly from your submission data through your form's PagSeguro tab (while editing your from > Form Properties > PagSeguro):

  • Name - a textbox field used to send the full name (the name has to be separated with space within your textbox; e.g. John Smith).
  • Email - a textbox field used to send the email address.
  • Area Code - map this to a field you're using for the area code (this can be a textbox or even a dropdown with pre-defined area codes).
  • Phone Number - a textbox for your phone number.
 
Submitting the order form

When the order form is submitted the following actions are taking place:

  • 1. The payment details are sent to PagSeguro
  • 2. The user is also redirected to the PagSeguro site where he will need to complete the paymnet

For more information on the actual transaction completion process please refer to the official PagSeguro documentation.

01 Apr 2020
Version 2.0.1
  • Added - Configuration option to display the PagSeguro Lightbox.
  • Updated - Payment total can be modified by placing items in RSFormProPagSeguro::getInstance()->items[]
31 Mar 2020
Version 2.0.0
  • Added - 'Name', 'Email', 'Areacode' and 'Phone number' can be mapped to fields.
  • Added - Parameters can be modified through RSFormProPagSeguro::getInstance().
  • Updated - Bumped minimum requirements to use PHP 5.4.27 and RSForm! Pro 2.2.0
  • Updated - PagSeguro PHP Library updated to 2.7.1
  • Fixed - Currency was hardocded as 'BRL', it will now be set according to Configuration - Payment - Currency.
  • Fixed - No error messages were shown when PagSeguro was used as a payment method but not configured properly.
20 Mar 2019
Version 1.51.1
  • Added - {_TRANSACTION_ID:value} support.
  • Updated - Bumped minimum requirements to use Joomla! 3.7.0
09 Oct 2015
Version 1.51.0
  • Added - Joomla! automatic updates support.
  • Updated - Bumped minimum requirements to use RSForm! Pro 1.51.0 and Joomla! 2.5.28
13 Jul 2015
Initial Release

6 persons found this article helpful.


Was this article helpful?

Yes No
Sorry about that