Sign in
latestOpenAPI 3.0.02026-08-106054.4 KB

42536792b3f8

Confirm Offer

Confirm Offer

The Confirm Offer endpoint is used to finalize the purchase of products from a previously created Offer. This endpoint converts the selected Offer into a confirmed booking after payment has been successfully collected.

Idempotency

This endpoint supports idempotency keys via the x-idempotency-key header to prevent duplicate transactions. Provide a unique operation identifier (e.g., UUID) to ensure safe retries. Duplicate requests return:

  • 409 Conflict: The request was already processed; response contains the cached original result (handle as success)
  • 423 Locked: The original request is still processing; retry after a short delay
post/partners/{partner_code}/offers/{offer_id}/confirm/

Headers

x-idempotency-keystring uuid

A unique identifier to ensure idempotent request processing. If a request with the same idempotency key and body has already been processed, the cached response is returned with a 409 Conflict status code (which can be treated as successful). Keys are stored for 48 hours.

Request body

require_payment_confirmationboolean

Enables two-step confirmation. If true, the booking is left in PENDING_PAYMENT until you call Confirm booking endpoint. Defaults to false, confirming in one step.

partner_transaction_idstring

Your internal transaction identifier

booking_agentobject

Agent information if booked through an agent

Response

OK

idstring
statusstring
currencystring
total_pricenumber
total_price_formattedstring
{"stackTrail":"paths:/partners/{partner_code}/offers/{offer_id}/confirm/:post:responses:200:content:application/json:schema:properties:partner_transaction_id","oasType":"schema","type":"unknown","nullable":true}
created_atstring date-time
updated_atstring date-time
pds_urlstring uri
security_tokenstring
account_urlstring uri
sign_up_urlstring uri
total_taxnumber
total_tax_formattedstring
total_premiumnumber
total_premium_formattedstring
fnol_linkstring uri
{"stackTrail":"paths:/partners/{partner_code}/offers/{offer_id}/confirm/:post:responses:200:content:application/json:schema:properties:booking_agent","oasType":"schema","type":"unknown","nullable":true}