Get the money

This page covers what the payment step needs to do at the point of booking — how the offer determines the payment type, how to convert the amount, and what to carry forward to create the booking.

The complete Adyen Drop-in implementation — fetching payment methods, making the payment request, handling 3D Secure, and reading the response — is covered in Accept payments online. This page covers only what is specific to the IBE booking flow.

Check the guarantee type

Each offer in the response from GET /booking/v1/offers includes a minGuaranteeType field. This determines what the payment step must do before creating the booking.

minGuaranteeType What to do
Prepayment Charge the guest at booking. Authorise the prePaymentGrossAmount and pass the pspReference to Apaleo when creating the booking.
CreditCard Do not charge. Perform a zero-amount authorisation to validate and store the card. Pass the resulting payment account to the booking.
PM6Hold No payment required at booking. Optionally ask for a card on file to guarantee late arrivals.

Most IBE rate plans use Prepayment. For the full handling of all three types, see Accept payments online — understand the guarantee type.

Convert the amount

Adyen expects the payment amount in minor units (cents). The prePaymentGrossAmount from the offers response is in major units (euros). Multiply by 100 before passing to Adyen:

prePaymentGrossAmount: 151.00 EUR  →  Adyen amount.value: 15100

This conversion is your responsibility — Apaleo does not perform it for you.

Implement the payment

Follow Accept payments online to implement the full Drop-in flow. The steps are:

  1. Fetch available payment methods — POST /paymentMethods
  2. Render Adyen Drop-in in your checkout page
  3. Authorise the payment — POST /payments, using the converted amount from above
  4. Handle any 3D Secure redirect — POST /payments/details

Do not authorise the payment until the guest is ready to confirm. Once authorised, Apaleo expects to receive the booking within 2 hours. If no booking arrives in that window, the authorisation is released automatically. For auto-capture payment methods a refund is issued instead.

What you need from this step

When the authorisation succeeds, store the following values before moving on to create the booking:

Value Where to find it Used for
pspReference Adyen /payments response transactionReference in the Apaleo booking request
recurring.shopperReference Adyen /payments response additionalData payerReference when creating a payment account
recurring.recurringDetailReference Adyen /payments response additionalData storedPaymentMethodId when creating a payment account

The pspReference is the only value required to create the booking. The tokenisation values are needed only if you want to store the card on file for future charges — see Create the booking — payment account.