RahalCorporate
OrdersReference

Order Statuses

Complete reference for order status values, meanings, and transitions

Order Statuses

Orders progress through a defined set of statuses as they move from creation to completion.

Status Values

StatusDescription
AcceptedOrder created, awaiting payment
PaidPayment verified, processing
In ProgressReservations being processed
FinalizedSuccessfully completed
Not PaidPayment not received (timeout)
FailedProcessing error occurred
RefundedOrder has been refunded

Detailed Descriptions

ACCEPTED

The initial status when an order is created.

Characteristics:

  • Order exists in the database
  • Payment session initiated but not completed
  • Prebook sessions linked to order
  • User has not finished payment

Next States: PAID, NOT_PAID

Automatic Transition: Orders in ACCEPTED for 24+ hours automatically transition to NOT_PAID via daily cron job (4 AM).

Payment has been verified by the payment provider.

Characteristics:

  • Transaction record created
  • System begins reservation processing
  • External bookings being created

Next States: IN_PROGRESS, FINALIZED, FAILED

IN_PROGRESS

Reservations are being processed asynchronously.

Characteristics:

  • Used for auto-ticketing suppliers
  • Background jobs verifying ticket issuance
  • Retries may be in progress

Next States: FINALIZED, FAILED

Retry Logic: System retries ticket verification up to 12 times with 5-minute intervals.

FINALIZED

All reservations successfully completed.

Characteristics:

  • All reservations have OK status
  • For flights: tickets issued
  • For corporate: budget confirmed
  • Order is complete

Next States: REFUNDED (if refunded later)

NOT_PAID

Payment was not completed within the allowed window.

Characteristics:

  • Automatic cleanup by cron job
  • Order cannot be recovered
  • User must create new order

Terminal State: No transitions from this status.

FAILED

An error occurred during order processing.

Characteristics:

  • Error event logged with details
  • May be recoverable with manual intervention
  • Requires investigation

Next States: FINALIZED (manual), REFUNDED

REFUNDED

Order has been refunded.

Characteristics:

  • One or more refunds processed
  • May be partial or full refund
  • Typically marks end of order lifecycle

Terminal State: No transitions from this status.

Status Transitions

Status by Provider

Different providers have different typical status flows:

ProviderTypical Flow
Consumer PaymentsAccepted → Paid → Finalized (or → In Progress → Finalized for auto-ticketing)
BNPLAccepted → Paid → Finalized (installment tracking continues)
Corporate DirectAccepted → Paid → Finalized (immediate, no payment step)
SandboxAccepted → Paid → Finalized (immediate, for testing)

Corporate Direct orders may be rejected before reaching Accepted status if policy or budget blocks the booking.

Manual Status Changes

Administrators can manually change order status in certain cases:

ActionTarget StatusUse Case
Mark as FinalizedFINALIZEDManual resolution of failed order
Mark as RefundedREFUNDEDMark order as refunded after processing

Manual status changes are logged as events. Use only when appropriate for the situation.

On this page