Reservation

Compatible Application Events for the “Reservation” entity

Reservation confirmed

RESERVATION_CONFIRMED

Fired asynchronously once a reservation has been confirmed.

VariableTypeAbout
reservationTicketReservationDetails about the reservation
billingDetailsBillingDetailsBilling info for the reservation
organizationOrganizationOrganizer details
transactionTransactionThe payment transaction of the reservation. Not defined if the reservation has no valid transaction

Reservation cancelled

RESERVATION_CANCELLED

Fired synchronously once one or more reservations have been cancelled.

VariableTypeAbout
reservationIdsCollection<String>Cancelled reservation IDs
reservationsList<TicketReservation>Cancelled reservations

Reservation expired

RESERVATION_EXPIRED

Fired synchronously once one or more reservations have expired.

VariableTypeAbout
reservationIdsCollection<String>Cancelled reservation IDs
reservationsList<TicketReservation>Cancelled reservations

Reservation validation

RESERVATION_VALIDATION

Fired synchronously when a reservation needs to be validated. No result expected, use the input BindingResult to add any validation errors

VariableTypeAbout
reservationIdStringReservation ID
reservationTicketReservationReservation to validate
formContactAndTicketsForm or PaymentFormCustomer provided input values
reservationTicketReservationReservation to validate
bindingResultBindingResultBinding result to register any validation errors

Tax ID validation

TAX_ID_NUMBER_VALIDATION

Fired synchronously when a Tax ID (VAT/GST) number has to be validated. Please note that Alf.io already supports EU VAT validation (by calling the EU VIES web service). In these cases, the TAX_ID validation will be called only as fallback. Your extension should return a failed validation result if the country is not supported. You can find an example here

Expected return type is boolean

VariableTypeAbout
taxIdNumberStringTAX ID number to validate
countryCodeStringISO 3166 2-letters country code

Invoice generation

INVOICE_GENERATION

Fired synchronously when generating an invoice. This allows for an integration with external billing systems.

Expected result is InvoiceGeneration or null

VariableTypeAbout
reservationIdStringReservation ID
emailStringCustomer email
customerNameCustomerNameCustomer first/last name
userLanguageStringISO 639-1 2-letters language code
billingAddressStringmulti-line billing address
billingDetailsBillingDetailsBilling data
customerReferenceStringCustomer reference (PO number)
reservationCostTotalPriceReservation price details
invoiceRequestedbooleanWether customer has requested an invoice
vatCountryCodeString2-digit TAX ID Country code
vatNrStringTAX ID
vatStatusPriceContainer.VatStatusTax application details
organizationOrganizationOrganizer details

Credit Note generation

CREDIT_NOTE_GENERATION

Fired synchronously when generating a credit note. This allows for an integration with external billing systems.

Expected result is CreditNoteGeneration or null

VariableTypeAbout
reservationIdStringReservation ID
invoiceNumberStringInvoice Number
organizationOrganizationOrganizer details

Credit Note generated

CREDIT_NOTE_GENERATED

Fired asynchronously after generating a credit note. This allows for an integration with external billing systems.

VariableTypeAbout
reservationIdStringReservation ID
reservationTicketReservationReservation details
billingDetailsBillingDetailsBilling data
reservationCostTotalPriceReservation price details
billingDocumentIdlongInternal Billing Document ID

Stuck reservations

STUCK_RESERVATIONS

Fired asynchronously when one or more “stuck” reservations are detected. A reservation is considered to be “stuck” if it’s expired while waiting for a confirmation from the payment provider

VariableTypeAbout
stuckReservationsIdList<String>Stuck reservations IDs

Offline payments about to expire

OFFLINE_RESERVATIONS_WILL_EXPIRE

Fired asynchronously when one or more offline payments are going to expire.

VariableTypeAbout
reservationsList<TicketReservationInfo>Reservation details

Refund issued

REFUND_ISSUED

Fired asynchronously after a refund has been issued.

VariableTypeAbout
reservationTicketReservationReservation details
transactionTransactionTransaction details
paymentInfoPaymentInformationPayment information

Dynamic discount application

DYNAMIC_DISCOUNT_APPLICATION

Fired synchronously when customer selects ticket categories in the event page. This allows you to define different discount policies based on the actual selection.

Expected result type: PromoCodeDiscount or null

VariableTypeAbout
quantityByCategoryMap<Integer, Long>How many tickets are being purchased for each category
reservationIdStringReservation ID - may be undefined