4. Credit Card Payments

Overview

The CREDIT_CARD payment method lets you pay for hotel bookings directly with a credit or debit card, including virtual credit cards (VCCs). You provide the card details in the booking request and the charge is processed automatically.

Prerequisites

• Credit card payments must be enabled on your account. Contact the LiteAPI team to activate this feature.
• Bookings with credit card payment must be sent to the secure booking endpoint:

https://pci-book.liteapi.travel/v3.0/rates/book

Booking Flow

The booking flow is the same as any other payment method — search, prebook, then book. The only difference is the subdomain (pci-book) and the payment object.

1. Search and Prebook

Use the standard endpoints as normal:

POST https://api.liteapi.travel/v3.0/hotels/rates
POST https://book.liteapi.travel/v3.0/rates/prebook

2. Book

Send the booking request to the secure endpoint with the card details:

POST https://pci-book.liteapi.travel/v3.0/rates/book

{
  "prebookId": "len80MPr_",
  "holder": {
    "firstName": "Jane",
    "lastName": "Smith",
    "email": "[email protected]"
  },
  "guests": [
    {
      "occupancyNumber": 1,
      "firstName": "Jane",
      "lastName": "Smith",
      "email": "[email protected]"
    }
  ],
  "payment": {
    "method": "CREDIT_CARD",
    "billingInfo": {
      "creditCardNumber": "4242424242424242",
      "creditCardIdentifier": "123",
      "creditCardExpirationMonth": "12",
      "creditCardExpirationYear": "2030",
      "holderName": "Jane Smith"
    }
  }
}

Payment Fields

3. Response

A successful booking returns the same response as any other payment method:

{
  "data": {
    "bookingId": "w-s4UgXom",
    "status": "CONFIRMED",
    "supplierBookingId": "14396822",
    "hotel": {
      "hotelId": "lp2369f1",
      "name": "Hotel Mio Vallarta"
    },
    "bookedRooms": [...],
    "paymentStatus": "succeeded",
    "paymentTransactionId": "tr_ct_TPcy6VTG-idLcuYiBoxEu"
  }
}

Cancellations and Refunds

Cancel credit card bookings the same way as any other booking:

PUT https://book.liteapi.travel/v3.0/bookings/{bookingId}

Refunds follow the hotel's cancellation policy. If the booking is within the free cancellation window, the full amount is refunded to the card.

Errors