A profile holds everything RO Payments needs to talk to your payment provider. You can make a profile for each payment provider, or several profiles for the same payment provider, for example with a different description or for subscriptions.
For a walk through this screen in Joomla itself, click Take a Tour in the top bar of the administrator and start the RO Payments Profile tour of your payment provider, for example RO Payments Profile: Mollie.
Create a profile
- Go to Components -> RO Payments -> Profiles
- Click New
- Select the Payment provider. The fields of that payment provider appear on the Settings tab.
- Enter a Name, which is only shown in the administrator
- Optionally enter an Alias, for example
mollie. Extensions and webhooks find the profile by its alias. Leave it empty to create it from the name, for examplemollie-shopfor the name Mollie shop. Do not change it once the profile is in use. - Fill in the Settings of the payment provider, see the article of your payment provider:
- Click Save
Each field has a description; click Toggle Inline Help in the toolbar to show them.
Settings
Besides the fields of the payment provider, the Settings tab has the Order Numbers: which number of the order RO Payments sends to the payment provider, the order number or the order ID. Buckaroo has a separate Invoice number as well.
Mollie and Stripe profiles also have the settings for subscriptions, see Recurring payments.
Payment Methods
After the first save, the Payment Methods tab lists the payment methods of the payment provider, each with its Code and Name. Add, change or remove payment methods to match your contract with the payment provider.
When you set up a payment option in your extension, you choose its payment method from this list. With the payment method set, the customer goes straight to that payment method. Without it, the customer chooses at the payment provider.
Status
The Status tab sets which order status the order gets in the extension for each payment result. The statuses to choose from are set up in Statuses.
| Field | What it does |
|---|---|
| Check Order Status | With Yes, RO Payments only updates an order that has the status of Order status for updating order. This prevents an order from being changed by accident, for example when it was handled by hand already. With No, the order is always updated, also when the result of the payment arrives after the customer returned. |
| Order status for updating order | The status an order must have to be updated, usually Pending |
| Order status for successful payments | The status of a paid order |
| Order status for cancelled payments | The status when the customer cancelled the payment (Mollie, Buckaroo and Stripe) |
| Order status for failed payments | The status when the payment failed |
| Order status for other payments | The status for every other result, for example a payment that is still open |
| Order status for expired payments | The status when the payment expired (Mollie) |
| Order status for refunded payments | The status after a refund (Mollie) |
| Order status for transfers | The status for a bank transfer that still has to be paid (Ginger Payments and Stripe) |
| Order status for charge backed payments | The status after a chargeback (Mollie) |
RO Payments can send its own emails, next to the emails of the extension:
| Field | |
|---|---|
| Incorrect order status | To the system managers when the order does not have the status for updating, so it was not updated |
| Payment information order | To the system managers with the result of each payment |
| Payment failure | To the system managers when a payment failed |
| Administrator - Notify Email | To the system managers when a customer goes to the payment provider. Useful when the extension sends no email before the order is paid. |
| System manager(s) email | A comma-separated list of the email addresses of the system managers |
| Customer email | To the customer when the status of the order changed |
The text of the emails is set in System -> Mail Templates. Filter on the extension RO Payments to see them.
Info
The Info tab links to the dashboard of the payment provider and to the list of its payment methods, with the code of each payment method.
The default profile
One profile is the default, marked in the Default column of Profiles. The payment page uses it when the address of the page has no profile. To change it, select a profile and click Actions -> Set Default.