Unfortunately, the username and password you have entered do not match!

Registration

Unfortunately, this username is already taken!

Unfortunately, this e-mail address is already used!

Please retype the verification code.

All fields are required

RSForm!Pro - PayPal plugin

RSForm!Pro - PayPal plugin

With the RSForm!Pro - PayPal plugin (New Payment Package) you can turn our form builder, RSForm!Pro into a small shopping cart. The integration uses the standard PayPal website payment method, the customer will be redirected to the PayPal page when the form is submitted where he will need to log in to his PayPal account and manually approve the transaction. After the payment is approved PayPal will send a notification to your site and the submission status will be changed to paid. If the transaction is not approved within 12 hours the payment will be marked as declined.

You can download the plugin from Downloads > My Downloads area of our website(make sure you're logged in) and install it through the standard Joomla! Extension Manager.


Available fields


The PayPal Plugin (New Payment Plugin) is the one in charge of specifying what needs to be paid. It adds the following fields to the form:


Single Product:


Adds a single product to the form. The user will be redirected to the payment page upon submission. For this type of field you can set up a caption, description and a price. Being a single use field (you can add only one in a given form), its internal name will always be the same, rsfp_Product.


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. A default value can also be set and, using HMTL attributes, you can render the field as readonly in order to have a fixed value for the donation (by adding readonly="readonly" in the field's Additional Attributes area).


Total:


This field is used alongside the Donation, Single and Multiple Products fields. It calculates the total price to be paid.


Starting with ver. 1.50.10, you can use the {total:price} placeholder to include the value calulated in this field in RSForm!Pro emails and thank you message. You will need to update the New Payment Plugin in order to use this placeholder.


Choose Payment:


Allows the user to choose his 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).


Starting with rev. 46 a new placeholder was added, {productfield:price}. This will return both the label and value (the product's price) of the item selected in the multiple product field's dropdown menu/checkbox group.



Multiple Payment Methods


After adding the payable "products" to your form, you need to add the Payment methods. The Payment methods have a (Payment) keyword in front of their name. When adding a new field you have the possibility of naming it (inside the "Label" field), so please use something descriptive (such as "Pay using your Credit Card through PayPal"). This label will appear in the "Choose Payment" field, as a Dropdown or Radio Group value. To this date, the Payment methods are:


  • (Payment) PayPal: allows the user to pay for his purchase using "PayPal Payments Standard" (ie the user is redirected to www.paypal.com where a purchase can be completed by using a credit card or a PayPal account)

  • (Payment) Offline: allows the user to pay using an offline payment method, such as a wire transfer. The details can be added in the "Wire transfer details" field, under the "Attributes" tab. You can use the {offline} placeholder in the Thank You Message or inside your emails to display this information to the user. If the Payment method is not "Offline" the placeholder will be replaced with a blank value.

In order to redirect the user successfully to the Payment processor you'll have to add the "Choose Payment" field as well as at least one Payment method. For legacy reasons, adding the PayPal Payment method without a "Choose Payment" field will automatically redirect the user to PayPal. This does not happen for the Offline Payment method. If you do not wish to display the "Choose Payment" field (eg. if you have only one payment option) you can always set the "Show in front-end?" attribute to "No". You can also use CSS to achieve the same effect if you are using a custom form layout without the "Auto Generate layout" option.


Important: In order for this plugin to actually work you will need to have the "Save data to database" option enabled. This option is found in the Form Properties tab.


Payments Configuration


After installing and enabling the New Payment Plugin, you will find the following payment configuration parameters in Components >> RSForm!Pro >> Configuration >> Payment tab:


  • Currency: Enter a 3-character currency code, for example USD - United States Dollar. Please consult this list when setting up your preferred currency.
  • Thousands Separator: Set a character to separate thousands. By default, this is set to , (comma)
  • Decimal Separator: Set a character to separate decimals. By default, this is set to . (dot)
  • Number of Decimals: Set a number of decimals to work with
  • Product Price Mask: Use the following placeholders to define a price mask for your multiple products fields: {product}, {price} and {currency}. You can place them in any order you like, and separate them by any characters or text. The multiple product fields' items will be generated based on this price mask
  • Total Price Mask: Use the following placeholders to define a price mask for your multiple products fields: {price} and {currency}. You can place them in any order you like, and separate them by any characters or text. The Total field will be displayed based on this price mask

PayPal Settings


The integration with PayPal requires a more ample configuration. You can set up the following PayPal-specific parameters in the Components >> RSForm!Pro >> Configuration >> PayPal tab:


  • PayPal E-mail Account: the email address you have used when creating your PayPal account
  • Return URL: Optional, provide an URL to which the users will be redirected after finalizing the payment
  • Cancel URL: Optional, provide an URL to which the users will be redirected after cancelling the payment
  • Live Mode: Yes / No - set to No in order to enable the testing mode
  • Tax Type: Percent (%) / Fixed Rate - Optional, set how you want to tax the form submitters - by a percentage of the total or by a fixed value
  • Tax Value: Set the value that will be applied in conjunction with the Tax Type field. Leave blank if you do not wish to apply a tax
  • Language code: Provide a 2-character language code. Please consult the Countries and Regions Supported by PayPal list for more information

Sending emails after the payment is made


You can now defer emails until after the payment is made. By going to the "Properties" main tab and scrolling down to "Payment Email Settings" you now have the following options:


  • Defer User Email: By setting this to "Yes" the User Email will be sent when the purchase is confirmed by the Payment gateway.

  • Defer Admin Email: By setting this to "Yes" the Admin Email will be sent when the purchase is confirmed by the Payment gateway.

  • Defer Additional Emails: By setting this to "Yes" all of the Additional Emails will be sent when the purchase is confirmed by the Payment gateway.

Examples and screenshots

  • Please note that this requires your website to be publicly accessible. PayPal will send a unique code back to your form and this is when the emails will be triggered. If access to your website is restricted (eg. through .htaccess, allowing only specified IPs to connect) this will not work.
Feedback