API

Sections

Theme switcher

/reservations/confirm

This endpoint can be used to confirm a reservation in carrier system.

For details about how this endpoint fits into the flow, check the Confirming Reservation step.

Header Parameters

api-keystring Required

Set your API key. To request a demo API key please reach out to us at partner@distribusion.com. Reference value: ZW8FXhnBl53yTkrMvoqLp4Xq7mf9nEBGsxpTWrid.

Body Parameters

reservation_idstring Required

Set the ID of the reservation to be confirmed. Use the value retrieved from /reservations/create response. Reference value: RAWFZHK9.

execute_paymentstring Required

Set the payment execution method. Standard value should be set to false for all retailers, unless discussed with your Partnership Manager. Reference value: false.

payment_methodstring Required

Set the payment method. Standard value should be set to demand_note for all retailers, unless discussed with your Partnership Manager. Reference value: demand_note.

terms_acceptedstring Required

Set the acceptance status of the terms by the passenger. Reference value: true.

send_customer_emailstring Required

Enable the standard Distribusion confirmation and cancellation email to be sent to the passenger. If set to false, retailer must send their own email with the pdf ticket attached. For more details check our Ticket Delivery guide. Reference value: true.

titlestring

Set the title of the lead passenger. The field accepts mr or mrs. Reference value: mr.

first_namestring Required

Set the first name of the lead passenger. Reference value: John.

last_namestring Required

Set the last name of the lead passenger. Reference value: Smith.

emailstring Required

Set the email of the lead passenger. Reference value: email@provider.com.

phonestring

Set the phone number of the lead passenger. Some carriers validate the phone number formatting. Reference value: +493533400275.

citystring

Set the city of the lead passenger. Reference value: Berlin.

zip_codestring

Set the city of the lead passenger. Reference value: 13355.

street_and_numberstring

Set the street and number of the lead passenger. Reference value: Wattstrasse 10.

retailer_booking_numberstring

Set the ID of the reservation/booking. This value can be created by the retailer and used to make identification easier. Reference value: ABC123.

transaction_referencestring

Set the ID of the payment retrieved from the retailer payment flow. It can be useful when the retailer has to do reconciliation of payments and bookings. Reference value: ABC123.

passengersarray

Show child attributes

Response

200 (reservation received)
Object
Successful response with reservation confirmation received

Response Attributes

dataobject

Show child attributes

jsonapiobject

Show child attributes

metaobject

Show child attributes

includedarray

Show child attributes

400 (reservation already confirmed)
Object
Error response: reservation already confirmed

Response Attributes

errorsarray

Show child attributes

jsonapiobject

Show child attributes

400 (reservation already cancelled)
Object
Error response: reservation already cancelled

Response Attributes

errorsarray

Show child attributes

jsonapiobject

Show child attributes

Was this section helpful?

What made this section unhelpful for you?

PUT

/

Select
1

Response

Was this section helpful?

What made this section unhelpful for you?

View as Markdown

Ask an AI

Open in ChatGPTOpen in ClaudeOpen in Perplexity

Code with AI

Open in Copilot