Setup Buckaroo

When using Buckaroo as a payment provider and the payment module for i-Reserve has been purchased, it is possible to process reservation payments directly via iDEAL, PayPal, or VISA.

Buckaroo setup

To ensure paid reservations are processed directly in i-Reserve, a feedback (push) from Buckaroo must be configured. This configuration is done in the Buckaroo Plaza dashboard.

1. Go to the Buckaroo website (https://plaza.buckaroo.nl/) and log in with the credentials provided by Buckaroo.
2. Click the menu item "Mijn Buckaroo" and then "Websites".
3. On the "General" tab, find the "Key". Note this key (e.g. "djAaU0PQJO") for use in i-Reserve.
4. Verify that the "URL" is correct. This is usually your i-Reserve environment URL (with https), e.g. mijnnaam.i-reserve.net.
5. Select "No" for "Use payment page".
6. Click on the "Redirect" tab.
7. Enable the checkbox "Activate frame busting".
8. Go to the "Push settings" tab.
9. Enable the checkboxes "Enable push response" and "Verify signature from response and transaction key (deprecated)".
10. Fill in the following URL under "Push URI success" and "Push URI Failure":
    https://{I-RESERVE-URL}/front?mod=paymentresult&method=4
    Replace {I-RESERVE-URL} with your actual i-Reserve environment.
11. Make sure the following fields are set as follows:
    Use HTTP Method: POST
    Push Type: BPE3.0 (if available)
    Hash method (HTTP push only): SHA1
    BPE return fields: Upper and lowercase
    Select push content type: http post
    (Other fields can remain empty)
12. Click the "3.0 settings" tab.
13. Enable "Activate double encoding on redirect", "Accept test transactions" and optionally "Auto-disable accept test transactions".
14. Click "Save".
15. Go to Configuration > Security > Secret Key.
16. Set a new secret key to use in i-Reserve (e.g. iReS3rVeKlANt) and save it for the next step.

i-Reserve setup

Now that the push from Buckaroo to i-Reserve is configured, the next step is setting up the i-Reserve side.

1. Log into your i-Reserve environment as administrator.
2. Navigate to Configuration > Modules > Payment Methods > Reservations.
3. Create a new payment method and select "Buckaroo" as the method.
4. Set Buckaroo mode to "Test mode".
5. Set Buckaroo URL to "https://testcheckout.buckaroo.nl/HTML/".
6. Set Buckaroo merchant to the key obtained earlier (e.g. "djAaU0PQJO").
7. Set Buckaroo secret to the secret key obtained earlier (e.g. "iReS3rVeKlANt").
8. Click Save and perform a test booking.

Enable full processing

Once testing is successful, switch to production mode:

1. Go to Configuration > Modules > Payment Methods > Reservations.
2. Open the payment method.
3. Set Buckaroo mode to "Full processing".
4. Set Buckaroo URL to "https://checkout.buckaroo.nl/HTML/".
5. Click Save and test again with a live booking.