Documentation

Initiate payment from an external link

A payment link opens the payment page with the amount, email address and description already filled in. Put it in an email, a message or an article, for example to ask for payment of an invoice.

Start with the address of the payment page menu item, for example https://example.com/pay, and add these values:

Value What it does
amount The amount, with a comma or a period for the decimals
email The email address of the customer
remark The description of the payment; write a space as %20
order_number Optional. Shown as a read-only field and used as order number of the payment
silent Optional. With silent=1 the form is not shown; the customer goes to the payment provider at once

For example:

https://example.com/pay?amount=100.50&email=This email address is being protected from spambots. You need JavaScript enabled to view it.&remark=Invoice%202026-0042&order_number=2026-0042

Without a menu item, use https://example.com/index.php?option=com_ropayments&view=pay and add the values with &.

When a required value is missing or wrong, the customer sees the form to complete it. For visitors who are not logged in, silent=1 only works when the site has no captcha, because the captcha needs to be filled in.

The link uses the profile of the payment page menu item. Make a payment page for each profile you want to use, for example https://example.com/donate with the donation profile, and add the values to it:

https://example.com/donate?amount=25&remark=Donation

A payment link in an article

The Button - RO Payments Payment Link editor button adds a link to an article:

  1. Edit the article and click Payment Link below the editor
  2. Enter the Link title, the text of the link
  3. Fill in the Amount, Email, Remark and Order Number you want in the link
  4. Set Instant redirect to Yes to send the customer to the payment provider at once
  5. Click Insert payment link

The button adds a tag such as

RO Payments

The System - RO Payments plugin turns the tag into a link when the page is shown. You can also type the tag yourself. An old RO Payments ...} tag still works.