Use this when the buyer has agreed to the quoted total: it creates the order exactly like the website's checkout and returns the secure payment link on pinflower.cz. Takes the quote's details plus terms_accepted, confirmed_total_czk (the agreed total) and order_intent; if the total has changed meanwhile, nothing is created and it returns the new breakdown instead. Takes: the bouquet(s) (bouquet_id from search; several bouquets of ONE florist with quantities in items); delivery or pickup; for delivery the street address with house number in Prague; the recipient's name and phone when someone else receives the flowers; the date and a time (one of the bouquet's offered times, or 'asap'); the buyer's name, e-mail and phone (+420…); an optional card message and note for the florist; the buyer's promo code if they have one. Above 10 000 Kč the buyer's billing address is required. Also on offer: address_mode 'ask_recipient' when the florist should agree the address with the recipient by phone — a surprise (the recipient's name and phone are then required); time 'agree_with_recipient' when the florist should agree the time with the recipient by phone (the recipient's name and phone are then required); add-ons per bouquet (listed in the bouquet details); recipient.care_reminder=true — the free (0 Kč) care reminder for the recipient, offered once when someone else receives the flowers; company details (IČO) for a purchase by a company. Nothing is charged here and the florist is not told until the buyer pays.
View input schema
{
"type": "object",
"properties": {
"address_mode": {
"type": "string",
"enum": [
"known",
"ask_recipient"
],
"description": "ask_recipient = the courier/florist agrees the address with the recipient by phone (a surprise); no address needed, delivery priced at the whole-city rate."
},
"florist_id": {
"type": "string",
"description": "The florist — required when the order is a custom bouquet alone."
},
"company": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"ico": {
"type": "string",
"description": "Czech company ID (IČO, 8 digits)."
},
"dic": {
"type": "string"
},
"address": {
"type": "string"
}
},
"required": [
"name",
"ico"
],
"description": "Buying for a company — the invoice is issued to it."
},
"bouquet_id": {
"type": "string",
"description": "One bouquet (shortcut for items with a single line)."
},
"items": {
"type": "array",
"minItems": 1,
"maxItems": 10,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"bouquet_id": {
"type": "string",
"description": "A bouquet_id as search results and bouquet details show it."
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"description": "How many of this bouquet (default 1)."
},
"addons": {
"type": "array",
"items": {
"type": "string"
},
"description": "Add-on keys the bouquet offers (its details list them as addons)."
},
"custom_budget_czk": {
"type": "integer",
"minimum": 390,
"maximum": 2400,
"description": "A bouquet composed by the florist to a budget (390–2400 Kč) instead of bouquet_id; the wishes go in florist_note."
}
}
},
"description": "Several bouquets from the SAME florist, with quantities."
},
"fulfilment": {
"type": "string",
"enum": [
"delivery",
"pickup"
]
},
"address": {
"type": "string",
"description": "Delivery to a known address: street and house number in Prague."
},
"unit": {
"type": "string",
"maxLength": 80,
"description": "Apartment, floor, company at the door."
},
"courier_note": {
"type": "string",
"maxLength": 200,
"description": "Bell name, entrance, gate code."
},
"date": {
"type": "string",
"description": "'today', 'tomorrow' or YYYY-MM-DD."
},
"time": {
"type": "string",
"description": "HH:MM from the offered times, or 'asap', or 'agree_with_recipient' (the florist agrees the time with the recipient by phone; delivery only)."
},
"buyer": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"description": "First name (or the full name)."
},
"last_name": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string",
"description": "+420…"
}
},
"required": [
"name",
"email",
"phone"
]
},
"recipient": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"phone": {
"type": "string",
"description": "+420…"
},
"care_reminder": {
"type": "boolean",
"description": "«A little extra care», free (0 Kč), off unless the buyer wants it: after the delivery Pinflower texts the recipient once (the sender ordered a care reminder; STOP opts out), and 3 days later sends one care tip. Delivery only, for a named recipient (recipient.phone is where the texts go — whose number it is does not matter); the recipient's language is unknown, the texts are Czech."
},
"sms_opt_out": {
"type": "boolean",
"description": "Legacy, ignored — the recipient is texted only for care_reminder."
}
},
"required": [
"name",
"phone"
],
"description": "Who receives the flowers, when it is someone else than the buyer — the courier calls them."
},
"billing_address": {
"type": "string",
"maxLength": 200,
"description": "The buyer's billing address — required by Czech tax rules when the order is over 10 000 Kč (unless buying for a company)."
},
"card_message": {
"type": "string",
"maxLength": 240
},
"florist_note": {
"type": "string",
"maxLength": 500
},
"promo_code": {
"type": "string",
"maxLength": 64,
"description": "The buyer's promo code, if they have one — works for guests and signed-in buyers alike; the checkout checks it."
},
"marketing_opt_in": {
"type": "boolean",
"description": "true = the buyer asked for news and offers."
},
"locale": {
"type": "string",
"enum": [
"cs",
"en",
"ru",
"uk"
]
},
"terms_accepted": {
"type": "boolean",
"description": "true = the buyer agreed to the terms."
},
"confirmed_total_czk": {
"type": "integer",
"minimum": 0,
"description": "The quoted total_czk the buyer agreed to — a different total refuses the order."
},
"order_intent": {
"type": "string",
"description": "The quote's order_intent. The same order_intent always returns the same order (a lost answer is safe to retry); each quote issues a new one."
}
},
"required": [
"date",
"time",
"buyer",
"terms_accepted",
"confirmed_total_czk",
"order_intent"
],
"additionalProperties": false
}