With the RO Payments - RSForm! Pro addon, visitors pay when they send a form. You can use RO Payments in two ways:
- Stand-alone: with the RO Payments fields only.
- With the RSForm! Pro Payment Package: RO Payments is one of the payment methods of the payment fields of RSForm! Pro.
Install the addon as described in Installation RO Payments, and create a profile first.
A form with the RO Payments fields
In the form, the RO Payments group of fields has:
| Field | What it does |
|---|---|
| Single Product | One product with a fixed price |
| Multiple Products | A list of products with a price each, shown as a dropdown, checkboxes or radio group, optionally with a quantity per product |
| Input box | A free field where the visitor enters an amount, for example for a donation |
| Discount | A field for a discount code |
| Profile | Lets the visitor choose the profile to pay with, for example to choose between payment providers |
| Total | The total of all selected products, calculated by RO Payments. It can be hidden. |
The Total field is required: RO Payments uses it to know whether and how much to pay. A form without it is sent without payment.
Then set the form settings in Form Properties -> RO Payments, at least the Payment provider alias when the form has no Profile field.
A form with the Payment Package
With the RSForm! Pro Payment Package, the payment fields of RSForm! Pro calculate the total, and the visitor chooses the payment method in its Choose Payment field. Add the (Payment) RO Payments field of the RO Payments group to make RO Payments one of the choices. The other RO Payments fields are not used.
See Show payment options in RSForms! Pro form to offer each payment method of your payment provider as its own choice.
Plugin settings
The RO Payments - RSForm! Pro plugin, in System -> Manage -> Plugins, has these settings for all forms:
| Field | What it does |
|---|---|
| Expire Hours | After how many hours a submission that was not paid gets the payment status Cancelled |
| Force scripts | Loads the RO Payments JavaScript on every page, for when the totals are not calculated because the script is not loaded |
| Extensions | A comma-separated list of extensions, for example com_content, whose pages load the RO Payments JavaScript, for forms shown in an article or a module |