Plugin - Payment Package (Wire Transfer, PayPal)

The Payment Package allows you to use the Payment Plugin with RSForm! Pro and to setup payments using PayPal or Offline payments.

The PayPal Plugin has been redesigned to allow multiple payment options on the same form, as well as a new "Donation" field.


This plugin can be downloaded by logging into our website using the account that holds the RSForm!Pro active subscription, heading to Downloads > RSForm!Pro > view all plugins and modules > RSForm! Pro Files > Plugins and clicking on the Payment Package (Payment Plugin + PayPal + Offline)


In order to install the plugin you will have to log in into your admin panel and head to Extensions > Extension Manager > Install tab > browse for the archive downloaded from our website and hit the Upload & Install button.

Plugin configuration

After installing the package you will notice that two tabs have been added within your RSForm!Pro Configuration page: Payments and PayPal each one with its own configuration options.



Using this tab you can configure the following options:

  • Currency - From here you can configure the currency code for the payments. In order to configure the currency code accordingly to the used payment gateway you can take a look at the following page: - PayPal
  • 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


In this tab are available the following options:

  • 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

Available fields

The 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)


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).


This field allows users to setup a Discount through Coupon Codes which can be found under Additional Attributes area. Add each value on a new line in the form of discount|code.

For example: 5%|DISCOUNT5 (which will give a 5% discount) / 15|ANOTHERCODE (which will give a flat 15 discount). You can also use PHP code in here to generate your discount codes.

{discount} and {discountprice} placeholders can be used to return the discount itself or respectively, the calculated discounted amount.


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

You can use the {total:price} placeholder to include the value calculated in this field in RSForm!Pro emails and thank you message.

If you have a tax configured for your payment, two more placeholders are available for usage {tax} and {grandtotal}. Which as suggested, will return the tax amount and the grand total being the total + tax.

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).

{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.

{productfield:amount} This will return only the price of an item without formatting.

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 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.

    A Tax can be set for this particular payment as well. It can either have a Percentual or a Fixed 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.

A full list of payment specific placeholders

(totalField and productField would be the actual field naming you've given to your elements; case sensitive):

Placeholder name Description
{totalField:price} The calculated total according to your set Total Price Mask
{totalField:amount} Returns the total price value without formatting
{tax} The tax amount
{grandtotal} Grand total value being the total + tax
{productField:price} Can return both the label and value (the product's price) - according to the Product Price Mask
{productField:amount} Will display only the price of an item without formatting
{discount} The discount, e.g. 15%
{discountprice} The calculated discounted value
{_STATUS:value} The status of your transaction.
{_TRANSACTION_ID:value} Returns the transaction ID. This would only work after the payment is done. If for example you're using it within your email contents, the email itself should be deferred until the payment is done (more details on deferring emails in the next section).

Only available when using the payment functionality in your form:

Transaction STATUS and ID can be found in the backend area > Components > RSForm!Pro > Manage Submissions > your form submissions > usually the most right columns from your listing information. If these do not show, click the "Choose which columns to show" button to include them.

In order to properly display the Transaction ID you will have to update the payment plugins you are currently using to the latest version. This can be achieved by downloading the latest version from our website and installing it over the current version(this acts as an update).

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.
  • Disable Deferring Emails for Offline Payments: By setting this to "Yes" all of the Emails will be skipped from deferring when the purchase was made using Offline Payment
  • 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.

31 persons found this article helpful.

Was this article helpful?

Yes No
Sorry about that

You Should Also Read

Create a subscription form using RSForm!Pro and PayPal HOT

How to add a quantity functionality to a PayPal form

Personalize PayPal parameters per form

RSform!Pro PayPal total field is not updated properly

I enabled the PayPal plugin to live mode but it still redirecting to sandbox