Ask for a payment on one of an own reseller's bookings
An own reseller's key made with the Payments right only. The same as POST /rentals/{slug}/bookings/{id}/payments, at the processor of the booking's rental. A reseller on Mellow takes the customer's money itself and sends prepaidMinor.
path Parameters
idAsk for a payment on one of an own reseller's bookings › Request Body
kindTake the money, or hold it as a deposit.
modeA page of the processor's to send them to, or a form of your own.
amountMinor units. Left out, a sale asks for what is due now (payNowMinor), or for the balance when only the fees paid on arrival are left. A hold asks for the deposit.
returnUrlWhere the customer lands after paying. Only for a link.
methodIdWhich online method, when the rental has more than one.
localeAsk for a payment on one of an own reseller's bookings › Responses
Started
The reseller's places, and each rental's location that serves them
A reseller's key only. With locale, each location's texts in that language, when the rental uses it. An own reseller keeps no places: each active location of its rentals is a place, with the location's id as its code and the location's name. A location the organization shares is one place for every rental.
query Parameters
localeThe reseller's places, and each rental's location that serves them › Responses
OK
Keep one car for 15 minutes at a fixed total
A reseller's key only. Hold the car while you charge the customer, then make the booking with holdId. The hold sends no email and the rental does not see it. Give it back with DELETE /holds/{id} when the customer leaves, or it ends by itself after 15 minutes. You keep at most 50 holds at one rental at once: one more answers 429 too_many_holds.
Keep one car for 15 minutes at a fixed total › Request Body
rentalThe rental's slug, from an offer.
carTypeIdpickupAt^\d{4}-\d{2}-\d{2}T\… · requiredreturnAt^\d{4}-\d{2}-\d{2}T\… · requiredpickupPlaceThe code of one of your places, such as KEF. An own reseller sends the location's id, the code from /places.
returnPlaceThe place the car comes back to, as pickupPlace.
levelIdThe Level the customer picked. Left out, the rental's included Level.
driverAgeThe driver's age in years, from 16 to 120, when known. A young driver fee goes on only with it. Under the car type's minDriverAge, the request is refused with driver_too_young.
Keep one car for 15 minutes at a fixed total › Responses
Held
The reseller's bookings on every rental
A reseller's key only. Oldest change first, then by id. Poll with updatedSince set to the last updatedAt you saw and afterId set to that booking's id: a change by the rental, such as a cancel or new dates, shows up there, and a booking with the same updatedAt on the next page is not skipped. reference finds your own booking number.
query Parameters
updatedSinceafterIdreferencelimitThe reseller's bookings on every rental › Responses
OK
Make a booking on one of the rentals
A reseller's key only. Send an Idempotency-Key header: a retry with the same key and body returns the same booking. A copy that arrives while the first is still being made answers 409 in_progress. After a 500 the key stays in progress for 24 hours and a retry answers 409 in_progress: read the bookings, and send a booking that is not there with a new key. The booking is made at once, as reserved, after a fresh check that a car is free.
Headers
idempotency-keyMake a booking on one of the rentals › Request Body
prepaidMinorWhat the customer paid you for the booking: the commission, the full price or any amount up to the total. The customer pays the rest at the rental.
referenceYour own booking number. Unique among your bookings.
rentalThe rental's slug, from an offer.
carTypeIdpickupAt^\d{4}-\d{2}-\d{2}T\…returnAt^\d{4}-\d{2}-\d{2}T\…pickupPlaceThe code of one of your places, such as KEF. An own reseller sends the location's id, the code from /places.
returnPlaceThe place the car comes back to, as pickupPlace.
levelIdThe Level the customer picked. Left out, the rental's included Level.
driverAgeThe driver's age in years, from 16 to 120, when known. A young driver fee goes on only with it. Under the car type's minDriverAge, the request is refused with driver_too_young.
holdIdA hold from POST /holds. With it, send no order fields: the booking takes the hold's order and total.
flightNumbernoteMake a booking on one of the rentals › Responses
Already made, same request
One of the reseller's bookings
path Parameters
idThe booking's id, or the id it had in the previous system when the booking came from an import.
The booking's id, or the id it had in the previous system when the booking came from an import.
One of the reseller's bookings › Responses
OK
Change the customer, the flight, the note or the prepaid amount
Send only what changes. Nothing here moves the price: new dates, a new car type, other places, extras or a Level are refused with not_allowed. Every change is refused once the car is out.
path Parameters
idChange the customer, the flight, the note or the prepaid amount › Request Body
flightNumbernoteprepaidMinorThe new total the customer prepaid to you, up or down. Refused once the rental took a payment itself.
Change the customer, the flight, the note or the prepaid amount › Responses
Changed
Cancel one of the reseller's bookings
Before pickup only. Mellow refunds nothing: you refund your customer what you charged. Optionally send {"reason": "…"}.
path Parameters
idCancel one of the reseller's bookings › Responses
Cancelled