Instruction
Configuration - Modules - Payment-bookings
This section only applies if the module Online payment is active.

With Stripe Checkout the payment runs entirely at Stripe: the payment form, the verification of the payment details and the security of the card data. i-Reserve sends the payment to Stripe and processes the return automatically — there is no webhook or callback for you to configure at Stripe.

Online payment is a module: it has to be active in your subscription. Background: What is a payment provider?

1. Create a Stripe account

Register a Stripe account in the name of your own organisation at stripe.com. Mind two choices that cannot be changed afterwards: the country of the account and the payout currency. Both help determine which payment methods you can offer.

2. Activate payment methods at Stripe

This is the most important step. i-Reserve does not send a list of payment methods to Stripe. Which methods your guest sees on the payment page is decided by Stripe, based on three things: the methods enabled in your Stripe dashboard, the currency of the reservation and the country of the guest.

Enable the methods you want in the Stripe dashboard under Settings > Payment methods. Card is enabled by default. iDEAL, Bancontact, TWINT and other local methods are enabled there one by one.

Example: TWINT only appears with a Swiss Stripe account and a payment in CHF. If the environment is set to euro, TWINT stays invisible — even when it is enabled at Stripe.

3. Retrieve the API keys

The Stripe dashboard holds two keys under Developers > API keys: the publishable key (starts with pk_) and the secret key (starts with sk_). Stripe keeps a separate set for test and for live: test keys contain _test_, live keys contain _live_.

4. Create the payment method in i-Reserve

Go to Configuration - Modules - Payment method reservations and choose Add new payment config. Fill in at least the fields below:

Method: Stripe
Type: Executed by customer
Description: your own wording, for example 'pay online'
Type of processing: choose 'Testmode' or 'Complete processing'

Then fill in the keys that match that choice. In test mode i-Reserve uses the test keys; with complete processing it uses the production keys:

Stripe public key (test) and Stripe secret key (test): the keys containing _test_
Stripe public key (production) and Stripe secret key (production): the keys containing _live_

Set the payment method to Active, and to Default when this is the method offered to the guest by default.

5. Test

Create a test reservation and walk through the payment. In test mode, use Stripe's test card numbers. Then check two things: is the reservation marked as paid in i-Reserve, and does the payment appear in the Stripe dashboard?

Note: test and production keys are not interchangeable. With 'Type of processing' set to 'Complete processing' but test keys filled in (or the other way round), the first real payment fails with an error from Stripe.

Never share the secret key by e-mail. Enter it directly in i-Reserve.