BOOKING FLOW

The objective of this document is to describe the booking flow.

📘

This flow is applicable across all verticals

Api Services

SectionDescription
Pre-BookEnsures that the fare obtained through the search is still valid for booking. Additionally, it provides a token with an expiration time, which is essential to proceed with the booking. This service is only available to active affiliates.
PaymentsQuotes the result of the pre-book and presents available payment methods, amounts, and discounts. Users can interact with this service by specifying the points customers wish to redeem, generating a quote that incorporates these redemptions.
BookResponsible for confirming and issuing the reservation.
StatusProvides updates about the status of the flight reservation.

Credit Card Payment

For partners who do not have their own payment gateway, Despegar provides access to a Koin-powered solution to enable credit card transactions.

  • Testing (Sandbox)
    • Sandbox credentials will be provided
  • Production
    • PCI certificate is required
    • Production credentials will be provided
  • Notes
    • This service must be requested when applying for API credentials and during account onboarding.

Koin URL: https://api-docs.koin.com.br/reference/tokenizecardpost


Flow

sequenceDiagram
    Actor Partner
    participant Prebook as /Prebook
    participant Payments as /Payments
    participant Book as /Book

    Partner->>Prebook: choice_id
    Prebook-->>Partner: prebook_id, expiration time

    Partner->>Payments: prebook_id
    Payments-->>Partner: plan_id

    Partner->>Book: prebook_id, plan_id, invoice info
    Book-->>Partner: 200 OK / estado de reserva