Reservation
Reservation confirmed
RESERVATION_CONFIRMED
Fired asynchronously once a reservation has been confirmed.
| Variable | Type | About |
|---|---|---|
reservation | TicketReservation | Details about the reservation |
billingDetails | BillingDetails | Billing info for the reservation |
organization | Organization | Organizer details |
transaction | Transaction | The 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.
| Variable | Type | About |
|---|---|---|
reservationIds | Collection<String> | Cancelled reservation IDs |
reservations | List<TicketReservation> | Cancelled reservations |
Reservation expired
RESERVATION_EXPIRED
Fired synchronously once one or more reservations have expired.
| Variable | Type | About |
|---|---|---|
reservationIds | Collection<String> | Cancelled reservation IDs |
reservations | List<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
| Variable | Type | About |
|---|---|---|
reservationId | String | Reservation ID |
reservation | TicketReservation | Reservation to validate |
form | ContactAndTicketsForm or PaymentForm | Customer provided input values |
reservation | TicketReservation | Reservation to validate |
bindingResult | BindingResult | Binding 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
| Variable | Type | About |
|---|---|---|
taxIdNumber | String | TAX ID number to validate |
countryCode | String | ISO 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
| Variable | Type | About |
|---|---|---|
reservationId | String | Reservation ID |
email | String | Customer email |
customerName | CustomerName | Customer first/last name |
userLanguage | String | ISO 639-1 2-letters language code |
billingAddress | String | multi-line billing address |
billingDetails | BillingDetails | Billing data |
customerReference | String | Customer reference (PO number) |
reservationCost | TotalPrice | Reservation price details |
invoiceRequested | boolean | Wether customer has requested an invoice |
vatCountryCode | String | 2-digit TAX ID Country code |
vatNr | String | TAX ID |
vatStatus | PriceContainer.VatStatus | Tax application details |
organization | Organization | Organizer 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
| Variable | Type | About |
|---|---|---|
reservationId | String | Reservation ID |
invoiceNumber | String | Invoice Number |
organization | Organization | Organizer details |
Credit Note generated
CREDIT_NOTE_GENERATED
Fired asynchronously after generating a credit note. This allows for an integration with external billing systems.
| Variable | Type | About |
|---|---|---|
reservationId | String | Reservation ID |
reservation | TicketReservation | Reservation details |
billingDetails | BillingDetails | Billing data |
reservationCost | TotalPrice | Reservation price details |
billingDocumentId | long | Internal 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
| Variable | Type | About |
|---|---|---|
stuckReservationsId | List<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.
| Variable | Type | About |
|---|---|---|
reservations | List<TicketReservationInfo> | Reservation details |
Refund issued
REFUND_ISSUED
Fired asynchronously after a refund has been issued.
| Variable | Type | About |
|---|---|---|
reservation | TicketReservation | Reservation details |
transaction | Transaction | Transaction details |
paymentInfo | PaymentInformation | Payment 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
| Variable | Type | About |
|---|---|---|
quantityByCategory | Map<Integer, Long> | How many tickets are being purchased for each category |
reservationId | String | Reservation ID - may be undefined |