API Reference
HomeAPI ReferenceGuidesChangelogKarhoo.com

Book a Trip only if the preauthorisation of the payment_nonce is successful

post
https://rest.sandbox.karhoo.com/v1/bookings/with-nonce

This endpoint is similar to /v1/bookings/ but it includes an extra payment_nonce parameter. You only need to use this endpoint if you were instructed by Karhoo to do so.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

request body

meta
object

Any key value pairs to be associated with a booking

string | null

The ID of the quote that should be used for pricing this Booking. This ID is obtained from the Quote Item List returned by the /v2/quotes/{id} API.

string

The ID of the service that should be used for pricing this Booking. This ID is obtained from the Service Item List returned by the /services/ API. If service_id is present in the booking request it takes a priority over the quote_id.

passengers
object
required
string
length ≤ 128

Trip ID provided by the demand partner.

string
length ≤ 512

Free form comments provided by the rider / person booking.

string
length ≤ 8

Flight number of passenger

string
length ≤ 15

Train number

string
length ≤ 35

Optional cost center reference to be used by the booker.

string
required

The nonce associated to the payment method that will be used to charge the passenger's credit card. Most integrations should ignore this parameter unless explicitly instructed by Karhoo on how to use it.

string

Train time

string

Loyalty nonce identifies a loyalty pre-authorisation, previously made by the passenger.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated over 2 years ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*

Updated over 2 years ago