Configuration for Rabo OnlineKassa / Rabo OmniKassa 2.0
A few notes
- There is a status page for Rabo OmniKassa, please bookmark and check it when you encountering issues.
- Rabo OmniKassa does not accept unusual TLD’s (top level domains). The usual TLD’s like .nl, .com will work, but for example .pro or .cc will not. You will get an error “merchantReturnURL top level domain is blacklisted”.
- Another thing to know about, for users of Rabo OmniKassa 1.0 is that the Rabobank changed the naming for the Rabo OmniKassa product. So Rabo OmniKassa 2.0 is now a larger “product” with more services by the Rabobank, and the online payments product is actually called “Rabo OnlineKassa”. Confusing, we know. That’s why in cciDEAL we will to use “Rabo OnlineKassa/Rabo OmniKassa 2.0” as much as possible.
- If you are customising your order ID in Joomla, Vituemart, HikaShop, cciDEAL Simpel etc, please note that Rabo OmniKassa only accepts one type of order ID to be sent to the dashboard, merchantOrderId. It limits the format, so only alphanumeric values (A-Z and 0-9) are accepted. Therefor cciDEAL will automatically convert any incorrect order ID’s do a format that Rabo OmniKassa does accept. Our advice is to customise the order ID if you want to but keep it alphanumeric.
Migrating to Rabo OmniKassa 2.0
If you are moving from Rabo OmniKassa 1.0 to Rabo OmniKassa 2.0, the bank has a manual about the migration to Rabo OmniKassa 2.0. You will need to update to at least cciDEAL 4.7.0 or higher first. After that, you can follow the below manual, basically you are changing the Account dropdown in Components > cciDEAL > Configuration to “Rabo OnlineKassa/Rabo OmniKassa 2.0”, as is explained below.
After installing cciDEAL 4.7.x, you need to refresh your browser cache.
If you use Rabo OmniKassa with Virtuemart, RSForm Pro or HikaShop and you have configured the payment methods (iDEAL, Bancontact etc) as separate options in the checkout of those extensions, you also need to update those options. Do this after you completed this manual.
- Extended configuration for Virtuemart
- Extended configuration for HikaShop
- Extra: adding more separate payment methods for RSForm Pro
Getting the account details
To configure your Rabo OmniKassa 2.0 account in cciDEAL, you need a Refresh key and Signing key for the production and sandbox servers. Both the Refresh key and Signing key look like a long string of random characters. You can find them in the Rabo OmniKassa 2.0 dashboard under: Beheer > Winkels en verkooppunten > Open the correct “webwinkel” > search for “API keys”. Please note, you need to complete the entire wizard to activate the API keys.
- Production API keys: a Refresh token and Signing key
- Sandbox API keys: a Refresh token and Signing key
To collect the API keys, follow the below steps:
- Go to the Rabo OmniKassa dashboard
- After logging in, click on “Beheer”
- Click on “Winkels en verkooppunten”
- Click on the webshop (webwinkel) that you want to integrate, or create that webshop if you didn’t already
- In the new screen search for “API keys”, this looks like the below screenshot.
- Please note, you need to complete the entire wizard to activate the API keys if you did not already.
- Keep this page open, so you can copy and paste the details to cciDEAL in the next part of this manual.
Configuring cciDEAL
With the collected API keys you can now continue to configure cciDEAL. For the steps below you need to be logged into the administrator of the Joomla! website.
- Open a new browser window or tab.
- To open a new tab on Windows is CTRL + T (click the CTRL button, then t on your keyboard)
- To open a new tab on MacOS use CMD + T click the CMD button, then t on your keyboard)
- In the new window/tab, go to the Joomla administrator for the webshop
- Login to Joomla
- Go to the cciDEAL configuration under Components > cciDEAL > Configuration.
- Inside Configuration at the General Settings select “Yes” at “Enable iDEAL”.
- Under “Account” select “Rabo OnlineKassa/Rabo OmniKassa 2.0” in the dropdown
- After you selected “Rabo OnlineKassa/Rabo OmniKassa 2.0” in the dropdown you should see a new grey area with 4 fields: Production: Refresh token, Signing key and Sandbox/Test: Refresh token, Signing Key. If you do not see them you need to refresh your browser cache.
- Select “Test” at “Account status”
- Enter the Rabo OmniKassa API keys. There are 4 fields for the production Refresh token and Signing key and and the sandbox Refresh token and Signing key. Enter all of them, so you can easily switch between the test/sandbox and production status. To enter the API keys, follow the below steps 4 times:
- Click on the browser window or tab that has the Rabo OmniKassa dashboard open
- Copy one of the details by clicking on “Refresh key kopieren” for example
- Click on the browser window or tab with the cciDEAL configuration
- Paste the API key you copied to the correct field
- Repeat steps 8.1 to 8.4 for all other API details
- Make sure you entered everything correctly, one tiny mistake in copy and pasting the keys might cost you a lot of time in troubleshooting!
- Click on the green “Save” button in the top of Joomla to save the cciDEAL configuration.
Setting the webhook URL
For Rabo OmniKassa 2.0/Rabo OnlineKassa, you need to manually set the webhook URL in the Rabo OmniKassa 2.0 dashboard. This was not required for Rabo OmniKassa 1.0, but it is now!
The format of the webhook URL is as shown below where “https://www.website.com/” needs to be replaced by your actual domain name and any possible subfolders your website is in.
https://www.website.com/index.php?option=com_ccidealplatform&task=raboomnikassa2_notify
- Go to the Rabo OmniKassa dashboard
- After logging in, click on “Beheer”
- Click on “Winkels en verkooppunten”
- Click on the webshop (webwinkel) that you want to integrate
- In the new screen search for “Websitekoppelingen” and click on “bewerken” on the right
- Paste the webhook URL in the webhook field
- Save this page.
Testing payments
- After configuring cciDEAL with your account details, place multiple test payments.
- The first way to test, is to use the “Test payment” button in cciDEAL at Components > cciDEAL > Configuration > General Settings > Test payment. If that works, continue with the next test.
- After you setup your webshop with HikaShop, Virtuemart, RSForm Pro or any other extension, test that integration. See the manuals “Adding iDEAL to …”.
- Go to the site and place a test payment via the integrated Joomla extension. Feel free to do as many test payments as you wish, testing any payment methods, products, currencies etc.
- Optional: if you love testing and want to do even more, check out this manual
Going to production
If you are satisfied with the tests, and want to go to production, you need to check that the Rabo OnlineKassa account is completely activated. It’s not enough to check this in the dashboard. We have had reports from customers, that all checks might be green in the dashboard, but Rabo OnlineKassa still wan’t activated by the bank. The only way to be sure, is to call the bank, and ask them if the Rabo OnlineKassa is 100% activated and “de aanvraag is afgerond”. After you did this, continue with the next steps.
- Go to the Joomla administrator
- Go to Components > cciDEAL > Configuration
- Select “Production” under the “Account” section
- Save the cciDEAL configuration
- Complete one real payment (where you actually pay yourself)
- If the real payment is successful (check payment status in cciDEAL and the Joomla extensions you integrated with), Rabo OmniKassa 2.0 is now implemented!
Frequently asked questions
Why isn’t the order ID in the dashboard the same as the order ID in Joomla?
- You did not enter the production details into the fields for the sandbox details and vice versa.
- You copied the complete token and key, and didn’t miss a character at the beginning or end. Do not copy and paste with your mouse, use the special “Kopieren” buttons. Otherwise you might miss some part of the token/key.
Rabo OmniKassa error: 5017 – payment brand ‘ALL’ is unknown.
Your integration with Rabo OmniKassa is incorrect and probably contains some old parts of Rabo OmniKassa 1.0. Please make sure all plugins are updated under cciDEAL > Configuration > Integrations.
If you coded a custom integration with cciDEAL, please remember that “ALL” is no longer allowed to define “Show all payment methods” the “paymentBrand” should be empty, see Integration manual.
Rabo OmniKassa error: 5017 – merchantReturnURL top level domain is blacklisted.
Rabo OmniKassa 2.0 does not accept unusual TLD’s (top level domains). The usual TLD’s like .nl, .com will work, but for example .pro or .cc will not. You will get an error “merchantReturnURL top level domain is blacklisted”. Please complain about this at the Rabobank, as I at least don’t understand why they chose to block these TLD’s. But prepare yourself to move to another domain or payment service provider, as I don’t think they will change this rule soon.