LogoLogo
SupportChangelogAPI ReferenceStatus
Distributor API
Distributor API
  • Welcome
  • Getting Started
    • Functionalities
    • Integration Process
      • Implementation Guide
    • OCTO & Prioticket
      • Feature Comparison
    • Postman & Interactive Documentation
    • Connect Once, Reach the World
      • Featured Suppliers
        • Supplier Overview Europe
        • Supplier Overview Americas
        • Supplier Overview Middle East
      • Featured Resellers
    • Statement on API Excellence
    • Frequently Asked Questions
  • Key Concepts
    • Product Structure
      • Product types and classes
      • Admission types
      • Extra Options
      • Pickup Points
      • Combi, Clusters, Bundles & Addons
        • Cluster
        • Combi
        • Addons
        • Bundle
    • Availability and Capacity
      • Availability
      • Capacity
        • Shared and Allocated Capacity
      • Availability API
    • Pricing Guide
      • Who are you?
      • Configurations
      • Variable Pricing
      • Dynamic Pricing
      • How It All Comes Together
    • Booking Logic
      • Cart Management
      • Payments
      • Cancellation & Refunds
      • Booking Questions
    • Additional Capabilities
      • Locations, Destinations and Categories
      • Recommendations
      • Promotions
      • Webhooks
      • Translations
    • Technical Concepts
      • Authentication
      • Idempotency
      • Rate Limiting
      • Timeout Handling
      • Error Handling
      • API versioning
      • Pagination
      • Formats
      • Headers
      • Caching
  • Endpoints
    • About
    • Authentication
    • System
    • Products
      • Stock
    • Availability
    • Reservations / Cart
      • Promocodes
    • Orders
      • Email & Vouchers
    • Payments
    • Contacts
    • Notifications
    • Models
  • Resources
    • Release notes
    • Roadmap
    • Postman
    • Swagger
    • Changelogs
      • Parameter Changelog
    • API Specs
      • V3.8 (Latest)
      • V3.7
      • V3.6
      • V3.5
    • Support
    • Certification
  • Status Dashboard
Powered by GitBook
On this page
  • Overview
  • How Does It Work?
  • When Should You Use It?
  • What Customers Will See
  • Adding a Promocode
  • Removing a Promocode
  • Why Is This Important?

Was this helpful?

Export as PDF
  1. Key Concepts
  2. Additional Capabilities

Promotions

Apply Discounts Effortlessly

The Promocode module allows customers to apply promotional codes to their reservations, unlocking discounts and special offers seamlessly.


Overview

This module supports adding and removing promocodes on existing reservations via API calls.

  • Add a promocode to apply a discount to the reservation/cart.

  • Remove a promocode to revoke the discount.

  • Validation ensures promocodes are valid, active, and applicable.

  • Detailed error messages guide the front-end UX for failed promocode attempts.


How Does It Work?

  • Add a Promocode: When a customer enters a promocode (like "SUMMER20"), it’s checked and applied to their reservation if valid.

  • Update Prices: Once added, the reservation’s price updates immediately to show the discount.

  • Remove a Promocode: If a customer changes their mind or enters the wrong code, they can easily remove it.

  • Clear Messages: If a promocode can’t be used (expired, already used, or not applicable), a friendly message explains why.

When Should You Use It?

  • To run special promotions like holiday sales, seasonal discounts, or exclusive offers.

  • To reward loyal customers with personalized discount codes.

  • To encourage larger bookings by offering percentage or fixed amount discounts.

What Customers Will See

  • The name and description of the promotion (e.g., “Christmas Sale: 20% off”).

  • The updated price after the discount is applied.

  • Helpful messages if the promocode can’t be accepted, like “This code has expired” or “You’ve already used this promocode.”

Adding a Promocode

  1. The customer enters their promocode during or after making a reservation.

  2. The system checks if the code is valid and can be used.

  3. If everything is good, the discount is applied, and prices update immediately.

  4. If the code isn’t valid, the customer gets an easy-to-understand message explaining why.

Removing a Promocode

If needed, the customer can remove a promocode anytime, and the price will update to reflect the change. Also, if the promocode was used and then cancelled, it will become available for future use again.

Why Is This Important?

  • It gives your customers control over applying discounts.

  • Promocodes help increase sales by encouraging customers to buy.

  • Clear, friendly messages improve customer satisfaction and reduce confusion.

  • Ensures your pricing stays accurate and transparent.

PreviousRecommendationsNextWebhooks

Last updated 13 days ago

Was this helpful?