> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payvessel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel Flight Order

> Cancel an unticketed reservation and reverse the original wallet debit, including the service charge

See [Cancel Order](/flight/cancel-order) for eligibility, full-refund behavior, retry guidance, and examples.


## OpenAPI

````yaml api-reference/vaas-services-openapi.json POST /vaas/api/v1/flight/orders/{order_id}/cancel
openapi: 3.1.0
info:
  title: PayVessel Value-Added Services API
  description: >-
    API reference for PayVessel biller reseller, eSIM, gift card, and flight
    services.
  version: 1.0.0
servers:
  - url: https://api.payvessel.com
  - url: https://sandbox.payvessel.com
security:
  - apiKey: []
    apiSecret: []
paths:
  /vaas/api/v1/flight/orders/{order_id}/cancel:
    post:
      tags:
        - Flight
      summary: Cancel Flight Order
      description: >-
        Cancel an eligible unticketed reservation for the authenticated
        business. No request body is required. Confirmation is required before
        reversing the original wallet debit, including the base fare and service
        charge. Repeating a confirmed cancellation does not repeat a completed
        refund. If a refund is pending, retry this endpoint for the same order.
        Issued tickets require support assistance. See the Cancel Order guide
        for eligibility and retry behavior.
      operationId: cancel_order_vaas_api_v1_flight_orders__order_id__cancel_post
      parameters:
        - name: order_id
          in: path
          required: true
          description: PayVessel order ID returned when the order was created
          schema:
            type: string
            format: uuid
            title: Order Id
        - name: api-key
          in: header
          required: true
          schema:
            type: string
            title: Api-Key
        - name: api-secret
          in: header
          required: true
          schema:
            type: string
            title: Api-Secret
      responses:
        '200':
          description: >-
            Flight order cancelled successfully, or already cancelled. Any
            eligible wallet refund has completed or was previously completed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CancelOrderResponseSchema'
        '401':
          description: API credentials are missing or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlightOrderErrorResponseSchema'
        '404':
          description: Flight order not found for the authenticated business
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlightOrderErrorResponseSchema'
              example:
                status: false
                message: Flight order not found
                data: null
                timestamp: '2026-10-16T10:00:30+00:00'
        '409':
          description: >-
            Order is ineligible, tickets are issued, the booking is not ready,
            or online cancellation is unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlightOrderErrorResponseSchema'
              example:
                status: false
                message: >-
                  Issued tickets cannot be cancelled through this API. Please
                  contact support
                data: null
                timestamp: '2026-10-16T10:00:30+00:00'
        '422':
          description: Invalid order ID format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlightOrderErrorResponseSchema'
        '424':
          description: >-
            Cancellation could not be confirmed, or cancellation succeeded but
            the wallet refund is pending
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlightOrderErrorResponseSchema'
              examples:
                cancellation_unconfirmed:
                  summary: Check the order status before retrying cancellation
                  value:
                    status: false
                    message: >-
                      Flight cancellation could not be confirmed. Please check
                      the order status before retrying
                    data: null
                    timestamp: '2026-10-16T10:00:30+00:00'
                refund_pending:
                  summary: >-
                    Booking cancelled; retry cancellation to retry the wallet
                    refund
                  value:
                    status: false
                    message: >-
                      Flight order cancelled, but the wallet refund is pending.
                      Please retry the cancellation to check the refund
                    data: null
                    timestamp: '2026-10-16T10:00:30+00:00'
        '500':
          description: An unexpected server error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlightOrderErrorResponseSchema'
components:
  schemas:
    CancelOrderResponseSchema:
      type: object
      title: CancelOrderResponseSchema
      required:
        - status
        - message
        - data
      properties:
        status:
          type: boolean
          title: Status
        message:
          type: string
          title: Message
        data:
          $ref: '#/components/schemas/api__flight__schemas__order__OrderSchema'
    FlightOrderErrorResponseSchema:
      type: object
      title: FlightOrderErrorResponseSchema
      required:
        - status
        - message
        - data
        - timestamp
      properties:
        status:
          type: boolean
          enum:
            - false
        message:
          type: string
        data: {}
        timestamp:
          type: string
          format: date-time
    api__flight__schemas__order__OrderSchema:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        business_id:
          type: string
          title: Business Id
        merchant_reference:
          type: string
          title: Merchant Reference
        order_reference:
          type: string
          title: Order Reference
        quote_id:
          type: string
          format: uuid
          title: Quote Id
        currency_code:
          type: string
          title: Currency Code
        pricing:
          $ref: '#/components/schemas/PricingBreakdownSchema'
        status:
          $ref: '#/components/schemas/FlightOrderStatus'
        error_message:
          anyOf:
            - type: string
            - type: 'null'
          title: Error Message
        ticket_info:
          anyOf:
            - $ref: '#/components/schemas/TicketInfoSchema'
            - type: 'null'
          default: null
        passengers:
          items:
            $ref: '#/components/schemas/PassengerSummarySchema'
          type: array
          title: Passengers
        created_datetime:
          type: string
          format: date-time
          title: Created Datetime
        updated_datetime:
          type: string
          format: date-time
          title: Updated Datetime
        completed_datetime:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Completed Datetime
      type: object
      required:
        - id
        - business_id
        - merchant_reference
        - order_reference
        - quote_id
        - currency_code
        - pricing
        - status
        - created_datetime
        - updated_datetime
      title: OrderSchema
    PricingBreakdownSchema:
      properties:
        currency_code:
          type: string
          title: Currency Code
        base_price:
          type: number
          minimum: 0
          title: Base Price
        service_charge:
          type: number
          minimum: 0
          title: Service Charge
        total_amount:
          type: number
          minimum: 0
          title: Total Amount
        wallet_reward_on_success:
          type: number
          minimum: 0
          title: Wallet Reward On Success
        price_status:
          $ref: '#/components/schemas/FlightPriceStatus'
      type: object
      required:
        - currency_code
        - base_price
        - service_charge
        - total_amount
        - wallet_reward_on_success
        - price_status
      title: PricingBreakdownSchema
    FlightOrderStatus:
      type: string
      enum:
        - pending
        - processing
        - success
        - failed
        - cancelled
      title: FlightOrderStatus
    TicketInfoSchema:
      type: object
      title: TicketInfoSchema
      properties:
        pnr_reference_number:
          anyOf:
            - type: string
            - type: 'null'
          default: null
        booking_status:
          anyOf:
            - type: string
            - type: 'null'
          default: null
        ticket_status:
          anyOf:
            - type: string
            - type: 'null'
          default: null
        payment_status:
          anyOf:
            - type: string
            - type: 'null'
          default: null
        ticket_passengers:
          type: array
          items:
            $ref: '#/components/schemas/TicketPassengerInfoSchema'
    PassengerSummarySchema:
      properties:
        passenger_type:
          type: string
          title: Passenger Type
          enum:
            - adult
            - child
            - infant
          description: 'Returned values: adult, child, infant.'
        first_name:
          type: string
          title: First Name
        middle_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Middle Name
        last_name:
          type: string
          title: Last Name
        title:
          anyOf:
            - type: string
              enum:
                - mr
                - mrs
                - ms
                - miss
                - master
            - type: 'null'
          title: Title
        gender:
          anyOf:
            - type: string
              enum:
                - male
                - female
            - type: 'null'
          title: Gender
      type: object
      required:
        - passenger_type
        - first_name
        - last_name
      title: PassengerSummarySchema
    FlightPriceStatus:
      type: string
      enum:
        - preview
        - final
      title: FlightPriceStatus
    TicketPassengerInfoSchema:
      type: object
      title: TicketPassengerInfoSchema
      properties:
        passenger_type:
          anyOf:
            - type: string
            - type: 'null'
          default: null
        first_name:
          anyOf:
            - type: string
            - type: 'null'
          default: null
        middle_name:
          anyOf:
            - type: string
            - type: 'null'
          default: null
        last_name:
          anyOf:
            - type: string
            - type: 'null'
          default: null
        ticket_number:
          anyOf:
            - type: string
            - type: 'null'
          default: null
        passenger_reference_number:
          anyOf:
            - type: string
            - type: 'null'
          default: null
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: api-key
      description: Your PayVessel business API key.
    apiSecret:
      type: apiKey
      in: header
      name: api-secret
      description: Your PayVessel business API secret.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.