Configuration for Rabo OmniKassa 1.0
Note: Consider switching to Mollie. With a rate of 29 cents per iDEAL transaction (without one-off or monthly costs), Mollie is one of the cheapest providers of payment services. Switching is easy and can be arranged (including activation) today, see the manual.
A few notes
There is a status page for Rabo OmniKassa on www.rabobank.nl/bedrijven/storing/, please bookmark it and refer to it when you are encountering issues.
Important Note:
If you are considering moving from Rabo Omnikassa to Rabo OmniKassa 2.0, the bank has a manual about the migration to Rabo OmniKassa 2.0. Please do 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 in this link
If you are considering moving from Rabo Omnikassa to Rabo OmniKassa 2.0, the bank has a manual about the migration to Rabo OmniKassa 2.0. Please do 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 in this link
Getting account details
To configure your Rabo OmniKassa account in cciDEAL, you need these details:
- Merchant ID (called Account ID in cciDEAL) – sent to you by the bank and also viewable on the Rabo OmniKassa download page
- Key version (called Sub ID in cciDEAL) – created on the Rabo OmniKassa download page
- Secret Key (called Private Key in cciDEAL) – created on the Rabo OmniKassa download page
The Rabobank also has an optional manual for the Rabo OmniKassa Download page!
So, to collect the Key version and Secret Key, follow the below steps:
- Go to the Rabo OmniKassa download page www.rabobank.nl/images/Handleiding
- To login use the username and password you received from the Rabobank
- If you logged in for the first time, you will need to change your password, just follow those steps on your screen now
- After changing your password, click on “Geheime sleutels” in the top right blue button
- In the new page, section “Geheime sleutels: informatie webwinkel” add any information that is empty
- If do not know your Merchant ID, it can be found here also (also called Winkel-ID)
- In section “Lijst van geheime sleutels”, there are probably no secret keys at the moment
- In section “Genereren geheime sleutel”, click on the button “Vragen om genereren” and confirm in the pop-up
- It can take some time for the Secret Key to generate. After 5 minutes refresh the page if its not created yet. If it takes longer then 5 minutes feel free to do something else and come back after a few hours.
- When the Secret Key is generated, it is shown in section “Lijst van geheime sleutels”, and it should be activated (Actief = Ja)
- From column “Versie” write down the Key version number
- From column “Sleutel” copy the Secret Key (you can use the copy to clipboard icon next to it)
- Tip: you might want to save the Key version and Secret Key on a secure location (in your computer backups)
The Rabo OmniKassa Dashboard can be used to view payments, process refunds, export data and more.
Configuring cciDEAL
With the collected details you can now continue to configure cciDEAL.
Rabo OmniKassa has a few test details you can use on any website for testing. You DO NOT have to copy these to cciDEAL, because we have hardcoded them into cciDEAL, and they will be automatically used when you set Rabo OmniKassa to “test”. So just enter your production details into the correct fields as described below.
- Account ID or MerchantID: 002020000000001
- Private Key or Secret Key: 002020000000001_KEY1
- Sub ID or Key Version: 1
For the steps below you need to be logged into the administrator of the Joomla! website.
- Go to the cciDEAL configuration under Components > cciDEAL > Configuration.
- Inside Configuration at the General Settings select “Yes” at “Enable iDEAL”
- Under “Account” select “Rabo OmniKassa” in the dropdown
- Select “Test” at “Account status”
- Enter the Rabo OmniKassa production account details
- Merchant ID should go in field “Account ID”
- Key Version should go in field “Sub ID”
- Secret Key should go in field “Private Key”
- For some integrations (the extensions you want to use should already be installed!) a new section “Payment method names” will become visible. An explanation can be found at the top of that section, but basically it’s an easy way to change the list of supported payment methods shown to customers in the site during checkout.
After you sent the contract to the Rabobank, you received an e-mail from the Rabobank. When Rabo OmniKassa is completely implemented you need to reply to that email, this is what Rabobank calls the “go-live mail”.
The Rabobank has a manual for the Rabo OmniKassa Dashboard which you should definitely read to be familiar with the options for managing transactions etc.
cciDEAL will update the payment status in the website even if your customer does not return to the website after payment (if he closes the browser too soon). But the Virtuemart confirmation e-mail will then not be sent, due to limitations in Rabo OmniKassa (not in cciDEAL!). We will try to find a work around in a future version of cciDEAL.
Testing payments
- After configuring cciDEAL with your account details, go to the site and place a test payment. Feel free to do as many test payments as you wish, testing any payment methods, products, currencies etc.
- If you are satisfied with the tests, go back to Components > cciDEAL > Configuration
- Select “Production” under the “Account” section
- Complete one real payment (where you actually pay yourself)
- If the real payment is successful (check payment status in cciDEAL and third party extensions you use), Rabo OmniKassa is now implemented!