Bookings
Prepay booking
Marks targeted orders as Prepaid: the passenger paid prepaid in advance and pays the rest on boarding. Authenticated via the api-key header; data scoped to the caller's partner. The same amount applies to every targeted ticket, in each ticket's own currency; to record different amounts, call once per subset of tickets. Hold, Booked and Prepaid orders can be prepaid; prepaying a Prepaid order replaces its amount. 400 when the amount is not less than a targeted ticket's price, or when a targeted ticket is not a PrexSell offer. 409 Conflict when any targeted order is Paid, Canceled, or Refund. All targeted orders are written together or none is. paymentRecipient is always Agent. As with Book booking, the carriers are notified when an order first becomes Prepaid (the passenger is not — tell your passenger yourself); changing the amount notifies no one. Prepaid orders do NOT fiscalize. Returns the refreshed booking after the write.
https://api.prexsell.com/v2/bookings/{id}/prepayAuthorizations
Path Parameters
idstringrequiredBooking identifier.
Example:
bkg_1
Body
application/jsonPrepay booking request body.
prepaidnumberrequiredAmount the passenger paid in advance, in the booking's currency. Greater than 0 and less than the price of every targeted ticket.
ticketIdsstring[]Optional subset of ticket IDs to act on. Must be a subset of the booking's current actor-owned tickets — any unknown or foreign ID returns 404 (not 403). Defaults to ALL current partner-owned tickets in the booking. Takes precedence over the deprecated orderIds alias when both are supplied.
Minimum array length:
1Ticket (order) identifier.
orderIdsstring[]deprecatedDEPRECATED — use
ticketIds. Optional subset of order IDs to act on. Must be a subset of the booking's current actor-owned orders — any unknown or foreign ID returns 404 (not 403). Defaults to ALL current partner-owned orders in the booking (current-state, not creation-snapshot — a booking's members change on peel-off).Minimum array length:
1Order identifier.
Response 200
application/jsonBooking action result (post-write refresh).
dataobjectrequiredAction result (refreshed booking state).
Response 400
application/jsonStandard error response body.
errorsobject[]requiredArray of error objects. Shape depends on origin: CustomError paths emit { message, errorCode } items; request-validation paths emit { message, field, ...constraint params } items, where
fieldis the offending request field (e.g. "departureDate").
Response 401
application/jsonStandard error response body.
errorsobject[]required
Response 404
application/jsonStandard error response body.
errorsobject[]required
Response 409
application/jsonStandard error response body.
errorsobject[]required