RO Payments

Migrate to RO Payments 9

With the release of RO Payments 9 we welcome a completely rewritten release of RO Payments. Out with the old, in with the new as they say. Let's see what this means for you.

 The most noticeable changes are the following:

  • The intermediate page has been removed. This means that customers go directly to the payment provider
  • A number of extensions and payment providers have been removed:
    • RD-Subscriptions
    • Joomshopping
    • Mijoshop
  • A number of payment providers have also undergone changes
  • Emails are no longer maintained in RO Payments itself but can be found in the Joomla Mail templates
  • Payment methods are no longer set in the profile but need to be passed on from the extension or chosen at the payment service provider. This allows you to use any supported payment method from your payment provider. Only caveat is that any payment requiring order details will not work as these are not passed on. Let us know if there is any particular payment method you would like to see supported and we can take a look and evaluate it for future inclusion
  • Batch update of Mollie recurring subscriptions
  • The cli/notify.php is no longer in use. This has been replaced by the URL https://YOUR_DOMAIN/notify If you have any exclusions set, they can be removed
  • Payment methods are no longer set in the profile. Either they are set in the extension where the customer chooses a payment method or the customer selects the desired payment method at the payment provider.
  • The J2Store plugin has been renamed to J2Commerce
  • Minimum requirements are Joomla 5 and PHP 8.2.

How to migrate?

Once you installed RO Payments 9 you will notice there are 2 RO Payments installed in your site. That is because the internal names are different and so they can co-exist. RO Payments 9 does however change the name from RO Payments to RO Payments (old). The reason we do this is because your old payment integration keeps working as-is and you have time to test the new RO Payments version. Do a migration on a test system first. Never migrate a production system without testing first.

On installation of RO Payments 9, we do try to migrate all settings from the old RO Payments installation but we ask you to verify it.

What to check?

There are a number of things to check, in no specific order:

  • Menu items
    The menu items will point to the old RO Payment pages, so make sure to update them by pointing them to the correct page. You can do that by editing the menu item and change the Menu Item Type to the new RO Payments page
  • Profiles
    Check that all profile details are correct. At the end of the article are links to the payment providers and how to configure them.
  • Messages
    Check that all messages are still present and linked to the correct profile
  • Emails
    Since the emails moved to the Joomla Mail Templates, you can check if they still have the correct markup

If anything is different you can double check with your current installation and make any necessary changes.

Notification URLs

Since we have removed the cli/notify.php and replaced it with 2 dedicated URLs /notify and /customer, you need to check that there are no menu items pointing to this URL, otherwise there will be issues in processing the response from the payment provider. To test you can call the URL https://YOUR_DOMAIN/notify and check that you get a 404 message, that means the URL is available to be used by RO Payments. The same can be done for the URL https://YOUR_DOMAIN/customer, this should also give you a 404 message. In case you already installed RO Payments 9, you will see a blank page with the word NOK for the /notify URL and a transaction ID not found message for the /customer URL.

Testing

Since this is a migration, make sure you test the complete payment flow on a test site before going live. After the test is done, test it again. Just to be sure it all works as expected.

Related Articles