Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Changed the definition of "create_checkout"
⟨12 unchanged words⟩ inline items + customer) into a checkout.CustomerThe customer's real name, email, mobile number andphonedelivery address arerequired.required; placeholder or test details are refused. Returns checkout_id. No payment link is minted yet ⟨12 unchanged words⟩
Changed the definition of "cancel_cart", "check_colour_stock", "complete_checkout" and 18 more
⟨25 unchanged words⟩ paid order already created from this cart. Irreversible—, create a new cart to restart.
{"additionalProperties":true,"properties":{"alternative_coloursavailable_colours":{"items":{"additionalPropertiestype":true"string"},"
Changed the definition of "cancel_cart", "cancel_checkout", "check_colour_stock" and 23 more
before
—after
{"additionalProperties":true,"properties":{"cancelled":{"type":"boolean"},"cart_id":{"type":"string"}},"required":["cancelled","cart_id"],"type":"object"}before
—after
{"additionalProperties":true,"properties":{"checkout_id":{"type":"string"},"status":{"type":"string"}},"required":["checkout_id","status"],"type":"object"}Certificate recorded, valid to 2026-11-14
Authorization not required
First tool surface recorded: 26 tools (server version 1.0.0)
Showing the latest 6 events. The API returns up to 500 and filters by kind: ?kind=tool_surface_changed
⟨27 unchanged words⟩ ,"checkout_id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"currency":{"const":"ZAR","type": ⟨38 unchanged words⟩ additionalProperties":true,"properties":{"colour":{"type":"string"},"finish":{"anyOf":[{"type":"string"},{"type":"null"}]},"heightdrop_mm":{"type":"number"},"mountTypemount_type":{"type":"string"},"priceproduct_name":{"type":"numberstring"},"productIdproduct_slug":{"type":"string"},"productNamequantity":{"type":"stringnumber"},"quantitytotal_price":{"type":"number"},"totalunit_price":{"type":"number"},"widthwidth_mm":{"type":"number"}},"required" ⟨9 unchanged words⟩ "next_step":{"type":"string"},"payment_method":{"anyOf":[{"type":"string"},{"type":"null"}]},"payment_status":{"anyOf":[{"type":"string" ⟨30 unchanged words⟩
{"additionalProperties":true,"oneOf":[{"properties":{"success":{"const":true}},"required":["configuration"]},{"properties":{"successcolour":{"const":false}},"requiredtype":["messagestring"]}],"properties":{"configurationcontact":{"additionalProperties":true,"properties":{"categoryemail":{"type":"string"},"colourname":{"type":"string"},"colour_hex":{"anyOfnote":[{"type":"string"},"whatsapp":{"type":"nullstring"}]},"contact_namerequired":{[],"type":"stringobject"},"contact_phonecurrency":{"typeconst":"stringZAR"},"contact_required":{"type":"booleanstring"},"currencydelivery":{"const":"ZAR","type":"string"},"effective_height_mm":{"type" ⟨10 unchanged words⟩ ,"height_mm":{"type":"number"},"lead_timein_stock":{"type":"stringboolean"},"material":{"anyOflead_time":[{"type":"string"},"limits":{"typeadditionalProperties":true,"nullproperties"}]:{},"measurement_review_requiredrequired":{[],"type":"booleanobject"},"messageminimum_charge_applied":{"type":"stringboolean"},"mount_type":{"type":"string"},"notenext_step":{"type":"string"},"product_idprice_zar":{"type":"stringnumber"},"product_nameproduct_id":{"type":"string"},"product_urlproduct_name":{"type":"string"},"quantity":{"type":"number"},"successsummary":{"type":"booleanstring"},"total_price_zar":{"type":"number"} ⟨3 unchanged words⟩ ,"vat_included":{"type":"boolean"},"whatsapp":{"type":"string"},"width_mm":{"type":"number"}},"required ⟨5 unchanged words⟩ ","quantity","unit_price_zar","total_price_zar","currency","vat_included"],"type":"object"},"contact_name":{"type":"string"},"contact_phone":{"type":"string"},"contact_required":{"type":"boolean"},"message":{"type":"string"},"note":{"type":"string"},"success":{"type":"boolean"}},"required":["success"],"type":"object"}
Start the open UCP purchase flow—, no auth needed. Creates a cart session and ⟨30 unchanged words⟩
⟨26 unchanged words⟩ Returns checkout_id. No payment link is minted yet—, call complete_checkout for that. Use update_checkout to correct customer details before finalising.
⟨14 unchanged words⟩ ,"checkout_id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"currency":{"const":"ZAR","type": ⟨38 unchanged words⟩ additionalProperties":true,"properties":{"colour":{"type":"string"},"finish":{"anyOf":[{"type":"string"},{"type":"null"}]},"heightdrop_mm":{"type":"number"},"mountTypemount_type":{"type":"string"},"priceproduct_name":{"type":"numberstring"},"productIdproduct_slug":{"type":"string"},"productNamequantity":{"type":"stringnumber"},"quantitytotal_price":{"type":"number"},"totalunit_price":{"type":"number"},"widthwidth_mm":{"type":"number"}},"required" ⟨9 unchanged words⟩ "next_step":{"type":"string"},"payment_method":{"anyOf":[{"type":"string"},{"type":"null"}]},"payment_status":{"anyOf":[{"type":"string" ⟨30 unchanged words⟩
Legacy auth-required tool—, prefer the open UCP flow (create_cart → ⟨28 unchanged words⟩ are re-verified server-side against the live pricing engine—, agent-supplied prices are ignored. Returns a Yoco or Ozow payment_url.
{"additionalProperties":true,"properties":{"contactap2":{"additionalProperties":true,"properties":{"contact_namemerchant_authorization":{"type":"string"}},"contact_phonerequired":["merchant_authorization"],"type":"object"},"checkout_id":{"type":"string"},"currency":{"const":"ZAR","type":"string"},"customer":{"additionalProperties":true,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"type":"string"},"notename":{"type":"string"},"currencyitem_count":{"consttype":"ZARnumber"},"items":{"anyOf":[{"items":{"additionalProperties":true,"properties":{"colour":{"anyOf":[{"type":"string"},{"item_counttype":"null"}]},"drop_mm":{"type":"number"},"mount_type":{"type":"string"},"product_name":{"type":"string"},"product_slug":{"type":"string"},"quantity":{"type":"number"},"total_price":{"type":"number"},"unit_price":{"type":"number"},"width_mm":{"type":"number"}},"required":[],"type":"object"},"type":"array"},{"type":"null"}]},"message":{"type":"string"},"order_idnext_step":{"type":"string"},"payment_urlorder_reference":{"type":"string"},"payment_method":{"anyOf":[{"type":"string"},{"type":"null"}]},"successpayment_url":{"anyOf":[{"type":"booleanstring"},{"total_zartype":"null"}]},"provider_reference":{"anyOf":[{"type":"numberstring"},{"type":"null"}]},"requiredstatus":{"anyOf":[{"successtype":"string"},{"order_idtype":"null"}]},"total_zar":{"type":"number"}},"currencyrequired":["order_reference","item_countcheckout_id","payment_urlstatus","messagepayment_url","contactmessage"],"type":"object"}
SurfaceReturns theARlinkmeasurementtotooltheorCustomproductBlindsvisualizermeasuring guide when a customerwants to measure their window orispreviewunsureahowblindtoinmeasure.theirThereroom.isTheno AR tool:usestheaguidephoneshowscamerahowandtoanmeasureA4forpageanasinsidea(recess)referenceorscaleoutsideto(facemeasurefix)windowfitdimensions.inThetwovisualizerminutes,rendersandtheaselectedcustomerblindwhoinisastillcustomer-uploadedunsureroomcanphoto.orderSetwithmodebesttoguess'measure'sizes,'visualize',receiveora'both'.freeOptionallytapepre-selectmeasureaandproduct_id.confirm before production starts.
{"additionalProperties":true,"properties":{"ar_measurement_notenote":{"type":"string"},"ar_measurement_urlproduct_id":{"type":"string"},"noteanyOf":[{"type":"string"},"product_visualizer_note":{"type":"stringnull"}]},"product_visualizer_urlurl":{"type":"string"}},"required":["url","note"],"type":"object"}
⟨14 unchanged words⟩ ,"checkout_id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"currency":{"const":"ZAR","type": ⟨38 unchanged words⟩ additionalProperties":true,"properties":{"colour":{"type":"string"},"finish":{"anyOf":[{"type":"string"},{"type":"null"}]},"heightdrop_mm":{"type":"number"},"mountTypemount_type":{"type":"string"},"priceproduct_name":{"type":"numberstring"},"productIdproduct_slug":{"type":"string"},"productNamequantity":{"type":"stringnumber"},"quantitytotal_price":{"type":"number"},"totalunit_price":{"type":"number"},"widthwidth_mm":{"type":"number"}},"required" ⟨9 unchanged words⟩ "next_step":{"type":"string"},"payment_method":{"anyOf":[{"type":"string"},{"type":"null"}]},"payment_status":{"anyOf":[{"type":"string" ⟨30 unchanged words⟩
Explain the production lead time for a new order. Production takes5–75 to 7 working days, excluding transit times and outside ⟨37 unchanged words⟩
⟨15 unchanged words⟩ soft-auth and must exactly match the order record—, prevents arbitrary order lookups. Returns payment status ( ⟨12 unchanged words⟩
{"additionalProperties":true,"properties":{"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"currency":{"const":"ZAR","type":"string"},"customer":{"additionalProperties":true,"properties":{"addressitems":{"anyOf":[{"typeitems":"string"},{"typeadditionalProperties":true,"nullproperties"}]},:{"citycolour":{"anyOf":[{"type":"string"},{"type":"null"}]},"stringnumber"},"namemount_type":{"type":"string"},"phone":{"anyOfproduct_name":[{"type":"string"},{"type":"null"}]}},"required":[],"type":"object"},"items":{"anyOf":[{"items":{"additionalProperties":true,"properties":{"colourproduct_slug":{"type":"string"},"finish":{"anyOf":[{"typequantity":"string"},{"type":"nullnumber"}]},"heighttotal_price":{"type":"number"},"mountTypeunit_price":{"type":"stringnumber"},"pricewidth_mm":{"type":"number"},"productId":{"type":"string"},"productName":{"typerequired":"string"}[],"quantity":{"type":"numberobject"},"total":{"type":"numberarray"},"width":{"type":"numbernull"}]},"requiredlead_time":[],{"type":"objectstring"},"typeorder_id":"array"},{"type":"nullstring"}]},"order_idorder_reference":{"type":"string"},"payment_methodorder_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"payment_statuspaid_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"statuspayment_status":{"anyOf":[{"type":"string" ⟨3 unchanged words⟩ type":"number"}},"required":["order_id","payment_status","total_zar","currency"],"type":"object"}
⟨9 unchanged words⟩ items":{"additionalProperties":true,"properties":{"display_name":{"type":"string"},"id":{"type":"string"},"methods":{"itemsname":{"type":"string"},"type":"array"},"redirect":{"type":"boolean"},"supports_3dsnote":{"type":"booleanstring"},"supports_bankssupports":{"items":{"type":"string"},"type":"array"},"webhook_verified":{"type":"boolean"}},"required":["id","display_name","methods","redirectname","webhook_verifiedsupports"],"type":"object"},"type": ⟨10 unchanged words⟩
{"additionalProperties":true,"oneOf":[{"properties":{"successcontact":{"constadditionalProperties":true}},"requiredproperties":["product_id","width_mm","height_mm","quantity","unit_price_zar","total_price_zar","currency","vat_included"]},{"propertiesemail":{"successtype":{"conststring":false}},"requiredname":[{"messagetype"]}],:"propertiesstring":{},"contact_namenote":{"type":"string"},"contact_phonewhatsapp":{"type":"string"}},"contact_requiredrequired":{[],"type":"booleanobject"},"currency":{"const":"ZAR","type":"string"},"delivery":{"type":"string"},"effective_height_mm":{"type":"number"},"effective_width_mm" ⟨11 unchanged words⟩ ,"lead_time":{"type":"string"},"measurement_review_requiredlimits":{"typeadditionalProperties":true,"booleanproperties":{},"messagerequired":{[],"type":"stringobject"},"noteminimum_charge_applied":{"type":"stringboolean"},"product_idnext_step":{"type":"string"},"quantityproduct_id":{"type":"numberstring"},"successproduct_name":{"type":"booleanstring"},"total_price_zarquantity":{"type":"number"},"unit_price_zartotal_price_zar":{"type":"number"},"vat_includedunit_price_zar":{"type":"booleannumber"},"stringboolean"},"width_mm":{"type":"number"}},"required":["successproduct_id","width_mm","height_mm","quantity","unit_price_zar","total_price_zar","currency","vat_included"],"type":"object"}
{"additionalProperties":true,"properties":{"product":{"additionalProperties":true,"properties":{"category":{"type":"string"},"colour_count_in_stock" ⟨35 unchanged words⟩ {"type":"string"}},"required":["name","in_stock"],"type":"object"},"type":" ⟨17 unchanged words⟩ ,"type":"array"},"max_height_mm":{"anyOf":[{"type":"number"},{"type":"null"}]},"max_width_mm":{"anyOf":[{"type":"number"},{"type":"null"}]},"name":{"type":"string"},"product_id" ⟨6 unchanged words⟩ {"type":"string"},"size_limits":{"anyOf":[{"additionalProperties":true,"properties":{"availability_rule":{" ⟨60 unchanged words⟩ ","validation_note"],"type":"object"},{"type":"null"}]},"starting_price_zar":{"anyOf":[{"type":"number"},{"type":"null"}]},"suitable_for":{"items":{"type":"string" ⟨4 unchanged words⟩ ","name","category","colours","product_url"],"type":"object"}},"required":["product"],"type":"object"}
⟨30 unchanged words⟩ and aesthetic. Returns a recommended product_id with rationale—, pass it to get_price or configure_product next. Security ⟨10 unchanged words⟩
⟨21 unchanged words⟩ , Sedgefield, etc.) route to Duncan Kane(+27795235407)for a free in-homeconsultation;consultation, booked on the same WhatsApp line (+27760228410); all other South African locations route tothe online shopthat line too (+27760228410). It is WhatsApp only, no voice calls. Use when the customer prefers human assistance or ⟨5 unchanged words⟩
⟨5 unchanged words⟩ when the customer has found the same blindcheaperat a lower price elsewhere. Custom Blinds matches verified South African retailer ⟨36 unchanged words⟩
RegisterLog up to 5 colourswatchescodestoagainstbeandispatchedEXISTINGwithordertheforcustomer'stheorder.teamSwatches(order_refshiprequired;atwithoutorderitplacementtheonlytool—returnstheystatusareorder_requiredNOTandsentlogsasnothing).aCustomstandaloneBlindspostaldoessamplenotbeforepostpurchase.individualCappedswatchesator5off-cuts.codesForperordersorder.overIfR8,000 the customeraskscan ask forswatchesthebeforefullordering,sampleexplainbooktheyviashipWhatsApp; if nothing suits, full refund withthenoblindfees.andNeverguidequotethematosample-bookplacepricetheirorordercourierfirst.cost.
⟨11 unchanged words⟩ WhatsApp number","type":"string"},"order_ref":{"description":"The order reference the swatches ship with. Required.","type":"string"},"product_interest":{"description":"e.g. 'Roller Blockout' or ⟨10 unchanged words⟩ "swatch_codes":{"description":"Optional specific colourcodes; no count limit enforced bycodesthis(maxhandler5)","items":{"type":"string"}, ⟨3 unchanged words⟩ :["customer_name","customer_email","customer_phone","product_interest","order_ref"],"type":"object"}
⟨18 unchanged words⟩ ,"message":{"type":"string"},"request_idnext_step":{"type":"numberstring"},"statusorder_ref":{"type":"string"},"swatch_countpolicy":{"type":"numberstring"}},"requiredrequest_id":[{"request_idtype":"number"},"status",:{"estimated_delivery_daystype":"string"},"swatch_count":{"type":"number"}},"required":["status","message"],"type":"object"}
{"additionalProperties":true,"properties":{"contact_namecontact":{"typeadditionalProperties":true,"stringproperties"},:{"contact_phoneemail":{"type":"string"},"notename":{"type":"string"},"productsnote":{"itemstype":{"additionalPropertiesstring":true},"properties":{"categorywhatsapp":{"type":"string"}},"colour_countrequired":{[],"type":"numberobject"},"descriptioncurrency":{"const":"ZAR","type":"string"},"featuresproducts":{"items":{"typeadditionalProperties":true,"stringproperties"},:{"category":{"type":"arraystring"},"idcolour_count_in_stock":{"type":"stringnumber"},"installation_typedescription":{"type":"string"},"materialsfeatures":{"items":{"type":"string"} ⟨2 unchanged words⟩ ,"name":{"type":"string"},"product_id":{"type":"string"},"product_url":{"type":"string"},"suitable_forstarting_price_zar":{"itemsanyOf":[{"type":"stringnumber"},{"type":"arraynull"}]}},"required":["idproduct_id","name","category","product_url"]," ⟨12 unchanged words⟩
Legacy auth-required tool—, prefer the open UCP flow (create_cart → ⟨41 unchanged words⟩
⟨3 unchanged words⟩ contact":{"additionalProperties":true,"properties":{"contact_name":{"type":"string"},"contact_phoneemail":{"type":"string"},"enquiry_id":{"type":"string"},"message":{"type":"string"},"success":{"type":"boolean"}},"required":["success","enquiry_id","message","contact"],"type":"object"}
⟨14 unchanged words⟩ ,"checkout_id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"currency":{"const":"ZAR","type": ⟨38 unchanged words⟩ additionalProperties":true,"properties":{"colour":{"type":"string"},"finish":{"anyOf":[{"type":"string"},{"type":"null"}]},"heightdrop_mm":{"type":"number"},"mountTypemount_type":{"type":"string"},"priceproduct_name":{"type":"numberstring"},"productIdproduct_slug":{"type":"string"},"productNamequantity":{"type":"stringnumber"},"quantitytotal_price":{"type":"number"},"totalunit_price":{"type":"number"},"widthwidth_mm":{"type":"number"}},"required" ⟨9 unchanged words⟩ "next_step":{"type":"string"},"payment_method":{"anyOf":[{"type":"string"},{"type":"null"}]},"payment_status":{"anyOf":[{"type":"string" ⟨30 unchanged words⟩
before
—after
{"additionalProperties":true,"properties":{"alternative_colours":{"items":{"additionalProperties":true,"properties":{"colour_name":{"type":"string"},"in_stock":{"type":"boolean"},"swatch_url":{"type":"string"}},"required":["colour_name","in_stock"],"type":"object"},"type":"array"},"available_colours":{"items":{"type":"string"},"type":"array"},"colour_name":{"type":"string"},"exact_colour_match":{"type":"boolean"},"expected_restock":{"anyOf":[{"type":"string"},{"type":"null"}]},"found":{"type":"boolean"},"in_stock":{"type":"boolean"},"matching_colours":{"items":{"additionalProperties":true,"properties":{"colour_name":{"type":"string"},"in_stock":{"type":"boolean"},"swatch_url":{"type":"string"}},"required":["colour_name","in_stock"],"type":"object"},"type":"array"},"message":{"type":"string"},"product_id":{"type":"string"},"requires_exact_colour_selection":{"type":"boolean"},"swatch_url":{"type":"string"}},"required":["in_stock"],"type":"object"}PhaseGenerate2aofYoco2.cardFinaliseoraOzowcheckoutinstant-EFTandpaymentmintlink;thethispaymentdoeslinkNOT—completeYocopayment.forRejectscardcancelledpaymentscheckoutsorandOzowrechecksforstockinstantandEFT.totals first. An atomic claim prevents competing gateway calls. Returns payment_urltoorsharenullwithplusthestatuscustomer.andPaymentmessage;confirmationcloudarrivescallersviamaywebhook;bepollheld.get_orderRetainafterwardsatosuccessfulconfirmURL:paidrepeatstatus.callsOncereturncalledpayment_pending with no URL. Gateway failures raise an error,thesendcheckoutnoispayment-linklockedemail—anduserequirecancel_checkoutteamtoreviewabortratherifthantheancustomerautomaticchangesretry.theirPollmindget_orderbeforewithpaying.customer_email for payment status.
before
—after
{"additionalProperties":true,"allOf":[{"if":{"properties":{"payment_url":{"type":"string"}},"required":["payment_url"]},"then":{"required":["total_zar","currency","payment_method"]}}],"properties":{"ap2":{"additionalProperties":true,"properties":{"merchant_authorization":{"type":"string"}},"required":["merchant_authorization"],"type":"object"},"checkout_id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"currency":{"const":"ZAR","type":"string"},"customer":{"additionalProperties":true,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"type":"string"},"name":{"type":"string"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":[],"type":"object"},"item_count":{"type":"number"},"items":{"anyOf":[{"items":{"additionalProperties":true,"properties":{"colour":{"type":"string"},"finish":{"anyOf":[{"type":"string"},{"type":"null"}]},"height":{"type":"number"},"mountType":{"type":"string"},"price":{"type":"number"},"productId":{"type":"string"},"productName":{"type":"string"},"quantity":{"type":"number"},"total":{"type":"number"},"width":{"type":"number"}},"required":[],"type":"object"},"type":"array"},{"type":"null"}]},"message":{"type":"string"},"next_step":{"type":"string"},"payment_method":{"anyOf":[{"type":"string"},{"type":"null"}]},"payment_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"payment_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_reference":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"total_zar":{"type":"number"}},"required":["checkout_id","status","payment_url","message"],"type":"object"}⟨26 unchanged words⟩ :"number"},"mount_type":{"description":"Mount type:Use inside (recess) or outside (face-fix); handler requires a nonempty value","enumminLength":["inside","outside"]1,"type":"string"},"product_id":{"description":"Product IDproduct_id fromsearch_productssearch_catalog or lookup_catalog","type":"string"},"province":{ ⟨48 unchanged words⟩
before
—after
{"additionalProperties":true,"oneOf":[{"properties":{"success":{"const":true}},"required":["configuration"]},{"properties":{"success":{"const":false}},"required":["message"]}],"properties":{"configuration":{"additionalProperties":true,"properties":{"category":{"type":"string"},"colour":{"type":"string"},"colour_hex":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact_name":{"type":"string"},"contact_phone":{"type":"string"},"contact_required":{"type":"boolean"},"currency":{"const":"ZAR","type":"string"},"effective_height_mm":{"type":"number"},"effective_width_mm":{"type":"number"},"finish":{"anyOf":[{"type":"string"},{"type":"null"}]},"height_mm":{"type":"number"},"lead_time":{"type":"string"},"material":{"anyOf":[{"type":"string"},{"type":"null"}]},"measurement_review_required":{"type":"boolean"},"message":{"type":"string"},"mount_type":{"type":"string"},"note":{"type":"string"},"product_id":{"type":"string"},"product_name":{"type":"string"},"product_url":{"type":"string"},"quantity":{"type":"number"},"success":{"type":"boolean"},"total_price_zar":{"type":"number"},"unit_price_zar":{"type":"number"},"vat_included":{"type":"boolean"},"whatsapp":{"type":"string"},"width_mm":{"type":"number"}},"required":["product_id","width_mm","height_mm","colour","mount_type","quantity","unit_price_zar","total_price_zar","currency","vat_included"],"type":"object"},"contact_name":{"type":"string"},"contact_phone":{"type":"string"},"contact_required":{"type":"boolean"},"message":{"type":"string"},"note":{"type":"string"},"success":{"type":"boolean"}},"required":["success"],"type":"object"}{"properties":{"customer":{"properties":{"address":{"type":"string"},"city":{"type":"string"},"email":{"description":"OptionalReal customerdetailsemail, checked before checkout creation","type":"string"},"name":{"description":"Real customer name, checked before checkout creation","type":"string"},"phone":{"description":"South African phone number, checked before checkout creation","type":"string"}},"type":"object"},"items":{"description":"Optionalinitialconfigured items; all submitted prices are ignored","items":{"properties":{"colour":{"description":"Exact(configuredavailableblinds)colour; validate with configure_product before adding","minLength":1,"type":"string"},"finish":{"description":"Optional pricing finish for aluminium Venetians","type":"string"},"height_mm":{"description":"Actual ordered drop in millimetres","exclusiveMinimum":0,"type":"number"},"mount_type":{"description":"Use inside for recess fit or outside for face fix","minLength":1,"type":"string"},"product_id":{"description":"product_id returned by search_catalog or lookup_catalog","type":"string"},"product_name":{"description":"Optional; server resolves the catalogue name","type":"string"},"quantity":{"description":"Number of blinds; defaults to 1","type":"number"},"total_price_zar":{"description":"Optional, ignored: server recalculates all totals","type":"number"},"unit_price_zar":{"description":"Optional, ignored: server recalculates all prices","type":"number"},"width_mm":{"description":"Actual ordered width in millimetres","exclusiveMinimum":0,"type":"number"}},"required":["product_id","width_mm","height_mm","colour","mount_type"],"type":"object"},"type":"array"}},"type":"object"}
before
—after
{"additionalProperties":true,"properties":{"cart_id":{"type":"string"},"created_at":{"type":"string"},"currency":{"const":"ZAR","type":"string"},"customer":{"anyOf":[{"additionalProperties":true,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"type":"string"},"name":{"type":"string"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":[],"type":"object"},{"type":"null"}]},"expires_at":{"type":"string"},"item_count":{"type":"number"},"items":{"items":{"additionalProperties":true,"properties":{"colour":{"type":"string"},"finish":{"anyOf":[{"type":"string"},{"type":"null"}]},"height_mm":{"type":"number"},"mount_type":{"type":"string"},"product_id":{"type":"string"},"product_name":{"type":"string"},"quantity":{"type":"number"},"total_price_zar":{"type":"number"},"unit_price_zar":{"type":"number"},"width_mm":{"type":"number"}},"required":["product_id","width_mm","height_mm","quantity","unit_price_zar","total_price_zar"],"type":"object"},"type":"array"},"total_zar":{"type":"number"},"updated_at":{"type":"string"}},"required":["cart_id","items","item_count","total_zar","currency","customer","created_at","updated_at","expires_at"],"type":"object"}{"anyOf":[{"required":["cart_id"]},{"properties":{"customer":{"required":["name","email","phone"]}},"required":["items","customer"]}],"properties":{"cart_id":{"description":"Either cart_id or items ⟨9 unchanged words⟩ {"type":"string"},"email":{"description":"Real customer email, checked before checkout creation","type":"string"},"name":{"description":"Real customer name, checked before checkout creation","type":"string"},"phone":{"description":"South African phone number, checked before checkout creation","type":"string"}},"type":"object"},"items":{"items":{"properties":{"colour":{"description":"Exact available colour; validate with configure_product before adding","minLength":1,"type":"string"},"finish":{"description":"Optional pricing finish for aluminium Venetians","type":"string"},"height_mm":{"description":"Actual ordered drop in millimetres","exclusiveMinimum":0,"type":"number"},"mount_type":{"description":"Use inside for recess fit or outside for face fix","minLength":1,"type":"string"},"product_id":{"description":"product_id returned by search_catalog or lookup_catalog","type":"string"},"product_name":{"description":"Optional; server resolves the catalogue name","type":"string"},"quantity":{"description":"Number of blinds; defaults to 1","type":"number"},"total_price_zar":{"description":"Optional, ignored: server recalculates all totals","type":"number"},"unit_price_zar":{"description":"Optional, ignored: server recalculates all prices","type":"number"},"width_mm":{"description":"Actual ordered width in millimetres","exclusiveMinimum":0,"type":"number"}},"required":["nameproduct_id","phoneheight_mm","colour","mount_type"],"type":"object"},"itemsminItems":{1,"type":"array"},"payment_method":{"description ⟨9 unchanged words⟩
before
—after
{"additionalProperties":true,"properties":{"ap2":{"additionalProperties":true,"properties":{"merchant_authorization":{"type":"string"}},"required":["merchant_authorization"],"type":"object"},"checkout_id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"currency":{"const":"ZAR","type":"string"},"customer":{"additionalProperties":true,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"type":"string"},"name":{"type":"string"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":[],"type":"object"},"item_count":{"type":"number"},"items":{"anyOf":[{"items":{"additionalProperties":true,"properties":{"colour":{"type":"string"},"finish":{"anyOf":[{"type":"string"},{"type":"null"}]},"height":{"type":"number"},"mountType":{"type":"string"},"price":{"type":"number"},"productId":{"type":"string"},"productName":{"type":"string"},"quantity":{"type":"number"},"total":{"type":"number"},"width":{"type":"number"}},"required":[],"type":"object"},"type":"array"},{"type":"null"}]},"message":{"type":"string"},"next_step":{"type":"string"},"payment_method":{"anyOf":[{"type":"string"},{"type":"null"}]},"payment_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"payment_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_reference":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"total_zar":{"type":"number"}},"required":["checkout_id","status","total_zar","currency"],"type":"object"}⟨75 unchanged words⟩ ,"width_mm","height_mm","colour","mount_type"],"unit_price_zartype":"object"},"total_price_zarminItems"]:1,"type":"objectarray"},"payment_method":{"default":"yoco","description":"Yoco card or Ozow instant EFT","enum":["yoco","ozow"],"type":"arraystring"}},"required":["items","customer_name" ⟨4 unchanged words⟩
before
—after
{"additionalProperties":true,"properties":{"contact":{"additionalProperties":true,"properties":{"contact_name":{"type":"string"},"contact_phone":{"type":"string"},"email":{"type":"string"},"note":{"type":"string"},"whatsapp":{"type":"string"}},"required":[],"type":"object"},"currency":{"const":"ZAR","type":"string"},"item_count":{"type":"number"},"message":{"type":"string"},"order_id":{"type":"string"},"payment_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"success":{"type":"boolean"},"total_zar":{"type":"number"}},"required":["success","order_id","total_zar","currency","item_count","payment_url","message","contact"],"type":"object"}before
—after
{"additionalProperties":true,"properties":{"ar_measurement_note":{"type":"string"},"ar_measurement_url":{"type":"string"},"note":{"type":"string"},"product_visualizer_note":{"type":"string"},"product_visualizer_url":{"type":"string"}},"required":["note"],"type":"object"}before
—after
{"additionalProperties":true,"properties":{"cart_id":{"type":"string"},"created_at":{"type":"string"},"currency":{"const":"ZAR","type":"string"},"customer":{"anyOf":[{"additionalProperties":true,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"type":"string"},"name":{"type":"string"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":[],"type":"object"},{"type":"null"}]},"expires_at":{"type":"string"},"item_count":{"type":"number"},"items":{"items":{"additionalProperties":true,"properties":{"colour":{"type":"string"},"finish":{"anyOf":[{"type":"string"},{"type":"null"}]},"height_mm":{"type":"number"},"mount_type":{"type":"string"},"product_id":{"type":"string"},"product_name":{"type":"string"},"quantity":{"type":"number"},"total_price_zar":{"type":"number"},"unit_price_zar":{"type":"number"},"width_mm":{"type":"number"}},"required":["product_id","width_mm","height_mm","quantity","unit_price_zar","total_price_zar"],"type":"object"},"type":"array"},"total_zar":{"type":"number"},"updated_at":{"type":"string"}},"required":["cart_id","items","item_count","total_zar","currency","customer","created_at","updated_at","expires_at"],"type":"object"}Poll aRead checkout by checkout_id. Returnsstatus (pending | paidpersisted|ordercancelled)status,fullpayment_status,itempayment_method,listitems, customerdetails, total_zar andpayment_urlcurrency.ifInitialalreadyorderminted.statusUseistostarted,verifynotcustomerpending.detailsThisbeforetoolcallingdoescomplete_checkout,notorreturntoaretrievepreviouslythegenerated payment_url:ifretain the complete_checkoutwasresponsealreadyincalled.caller context.
before
—after
{"additionalProperties":true,"properties":{"ap2":{"additionalProperties":true,"properties":{"merchant_authorization":{"type":"string"}},"required":["merchant_authorization"],"type":"object"},"checkout_id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"currency":{"const":"ZAR","type":"string"},"customer":{"additionalProperties":true,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"type":"string"},"name":{"type":"string"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":[],"type":"object"},"item_count":{"type":"number"},"items":{"anyOf":[{"items":{"additionalProperties":true,"properties":{"colour":{"type":"string"},"finish":{"anyOf":[{"type":"string"},{"type":"null"}]},"height":{"type":"number"},"mountType":{"type":"string"},"price":{"type":"number"},"productId":{"type":"string"},"productName":{"type":"string"},"quantity":{"type":"number"},"total":{"type":"number"},"width":{"type":"number"}},"required":[],"type":"object"},"type":"array"},{"type":"null"}]},"message":{"type":"string"},"next_step":{"type":"string"},"payment_method":{"anyOf":[{"type":"string"},{"type":"null"}]},"payment_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"payment_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_reference":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"total_zar":{"type":"number"}},"required":["checkout_id","status","total_zar","currency"],"type":"object"}before
—after
{"additionalProperties":true,"properties":{"delivery_after_dispatch":{"type":"string"},"estimated_dispatch_date":{"type":"string"},"expedited_available":{"type":"boolean"},"important":{"type":"string"},"order_date":{"type":"string"},"production_working_days":{"type":"number"},"summary":{"type":"string"}},"required":["order_date","production_working_days","estimated_dispatch_date","delivery_after_dispatch","expedited_available","summary","important"],"type":"object"}before
—after
{"additionalProperties":true,"properties":{"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"currency":{"const":"ZAR","type":"string"},"customer":{"additionalProperties":true,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"type":"string"},"name":{"type":"string"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":[],"type":"object"},"items":{"anyOf":[{"items":{"additionalProperties":true,"properties":{"colour":{"type":"string"},"finish":{"anyOf":[{"type":"string"},{"type":"null"}]},"height":{"type":"number"},"mountType":{"type":"string"},"price":{"type":"number"},"productId":{"type":"string"},"productName":{"type":"string"},"quantity":{"type":"number"},"total":{"type":"number"},"width":{"type":"number"}},"required":[],"type":"object"},"type":"array"},{"type":"null"}]},"order_id":{"type":"string"},"payment_method":{"anyOf":[{"type":"string"},{"type":"null"}]},"payment_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"total_zar":{"type":"number"}},"required":["order_id"],"type":"object"}before
—after
{"additionalProperties":true,"properties":{"default_currency":{"const":"ZAR","type":"string"},"handlers":{"items":{"additionalProperties":true,"properties":{"display_name":{"type":"string"},"id":{"type":"string"},"methods":{"items":{"type":"string"},"type":"array"},"redirect":{"type":"boolean"},"supports_3ds":{"type":"boolean"},"supports_banks":{"items":{"type":"string"},"type":"array"},"webhook_verified":{"type":"boolean"}},"required":["id","display_name","methods","redirect","webhook_verified"],"type":"object"},"type":"array"},"note":{"type":"string"}},"required":["default_currency","handlers","note"],"type":"object"}Get an exact ZAR pricefor a product at specific dimensions. Requiresusing product_id(fromsearch_productssearch_catalog or lookup_catalog), width_mm,and height_mm.ReturnsPricesunit_price_zarinclude VAT andtotal_price_zardelivery.(VATColourincluded).selectsCalltheconfigure_productbamboonextpricetotierlockwhereinapplicable. A price is not a stock reservation: validate the exact colour and mounttypewith configure_product before creating a cart. Failure can return success:false or a JSON-RPC validation error.
{"properties":{"colour":{"description":"Optional bamboo colour for colour-specific tier pricing","type":"string"},"finish":{"description":"Optional finish for aluminium ⟨14 unchanged words⟩ :"number"},"product_id":{"description":"Product IDproduct_id fromsearch_productssearch_catalog or lookup_catalog (e.g. roller-blockout, venetian-25mm-aluminium)","type":"string"},"province": ⟨48 unchanged words⟩
before
—after
{"additionalProperties":true,"oneOf":[{"properties":{"success":{"const":true}},"required":["product_id","width_mm","height_mm","quantity","unit_price_zar","total_price_zar","currency","vat_included"]},{"properties":{"success":{"const":false}},"required":["message"]}],"properties":{"contact_name":{"type":"string"},"contact_phone":{"type":"string"},"contact_required":{"type":"boolean"},"currency":{"const":"ZAR","type":"string"},"effective_height_mm":{"type":"number"},"effective_width_mm":{"type":"number"},"finish":{"anyOf":[{"type":"string"},{"type":"null"}]},"height_mm":{"type":"number"},"lead_time":{"type":"string"},"measurement_review_required":{"type":"boolean"},"message":{"type":"string"},"note":{"type":"string"},"product_id":{"type":"string"},"quantity":{"type":"number"},"success":{"type":"boolean"},"total_price_zar":{"type":"number"},"unit_price_zar":{"type":"number"},"vat_included":{"type":"boolean"},"whatsapp":{"type":"string"},"width_mm":{"type":"number"}},"required":["success"],"type":"object"}before
—after
{"additionalProperties":true,"properties":{"product":{"additionalProperties":true,"properties":{"category":{"type":"string"},"colour_count_in_stock":{"type":"number"},"colours":{"items":{"additionalProperties":true,"properties":{"expected_restock":{"anyOf":[{"type":"string"},{"type":"null"}]},"finish":{"anyOf":[{"type":"string"},{"type":"null"}]},"hex":{"anyOf":[{"type":"string"},{"type":"null"}]},"in_stock":{"type":"boolean"},"material":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"}},"required":[],"type":"object"},"type":"array"},"description":{"type":"string"},"features":{"items":{"type":"string"},"type":"array"},"installation_type":{"type":"string"},"materials":{"items":{"type":"string"},"type":"array"},"max_height_mm":{"type":"number"},"max_width_mm":{"type":"number"},"name":{"type":"string"},"product_id":{"type":"string"},"product_url":{"type":"string"},"schema_url":{"type":"string"},"size_limits":{"additionalProperties":true,"properties":{"availability_rule":{"type":"string"},"combination_dependent":{"type":"boolean"},"max_height_mm":{"type":"number"},"max_width_mm":{"type":"number"},"measurement_note":{"type":"string"},"minimum_charge_height_mm":{"type":"number"},"minimum_charge_width_mm":{"type":"number"},"product_id":{"type":"string"},"unit":{"const":"mm","type":"string"},"validation_note":{"type":"string"},"width_drop_frontier":{"items":{"additionalProperties":true,"properties":{"max_drop_mm":{"type":"number"},"width_band_max_mm":{"type":"number"}},"required":["width_band_max_mm","max_drop_mm"],"type":"object"},"type":"array"}},"required":["product_id","unit","max_width_mm","max_height_mm","minimum_charge_width_mm","minimum_charge_height_mm","combination_dependent","availability_rule","width_drop_frontier","measurement_note","validation_note"],"type":"object"},"suitable_for":{"items":{"type":"string"},"type":"array"}},"required":["product_id","name","category","colours","product_url"],"type":"object"}},"required":["product"],"type":"object"}before
—after
{"additionalProperties":true,"properties":{"handoff":{"additionalProperties":true,"properties":{"product_family":{"type":"string"},"reason":{"type":"string"},"url":{"type":"string"}},"required":["url","product_family","reason"],"type":"object"},"notes":{"type":"string"},"recommendations":{"items":{"additionalProperties":true,"properties":{"currency":{"const":"ZAR","type":"string"},"product_id":{"type":"string"},"product_name":{"type":"string"},"reason":{"type":"string"},"shop_url":{"type":"string"},"starting_price_zar_for_1m_x_1m":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["product_id","product_name","reason","starting_price_zar_for_1m_x_1m","currency","shop_url"],"type":"object"},"type":"array"}},"required":["recommendations"],"type":"object"}before
—after
{"additionalProperties":true,"properties":{"reason":{"type":"string"},"recipient":{"type":"string"},"recipient_phone":{"type":"string"},"whatsapp_url":{"type":"string"}},"required":["whatsapp_url","recipient","recipient_phone","reason"],"type":"object"}StructuredPreferredcataloguestructuredfilter:discovery.narrowFilter by category(roller | venetian |,honeycombpartial|colourverticalname|oroutdoor),requiredcoloursupportedname,width/dropmax_width_mm,inormm.max_height_mm.ReturnsIdealresultswhencontainingtheproduct_id,customername,hascategorystatedandaproduct_url,blindplustype.total.ReturnsWidth/dropmatchingfiltersproductscheckwithseparateidmaximums,andnotproduct_url.everyUsecombination;search_catalogconfirmfortheopen-endedexactnaturalpairlanguagewithqueries.get_price.
before
—after
{"additionalProperties":true,"properties":{"results":{"items":{"additionalProperties":true,"properties":{"category":{"type":"string"},"name":{"type":"string"},"product_id":{"type":"string"},"product_url":{"type":"string"}},"required":["product_id","name","category","product_url"],"type":"object"},"type":"array"},"total":{"type":"number"}},"required":["results","total"],"type":"object"}before
—after
{"additionalProperties":true,"properties":{"claim_summary":{"additionalProperties":true,"properties":{"competitor":{"type":"string"},"competitor_price_zar":{"type":"string"},"dimensions":{"type":"string"},"product_id":{"type":"string"}},"required":["product_id","dimensions","competitor","competitor_price_zar"],"type":"object"},"exclusions":{"items":{"type":"string"},"type":"array"},"message":{"type":"string"},"note":{"type":"string"},"success":{"type":"boolean"},"whatsapp_url":{"type":"string"}},"required":["success","claim_summary","whatsapp_url","message","exclusions","note"],"type":"object"}⟨31 unchanged words⟩ "swatch_codes":{"description":"Optional specific colourcodescodes;(maxno5)count limit enforced by this handler","items":{"type":"string"}, ⟨9 unchanged words⟩
before
—after
{"additionalProperties":true,"properties":{"estimated_delivery_days":{"additionalProperties":true,"properties":{"max":{"type":"number"},"min":{"type":"number"}},"required":["min","max"],"type":"object"},"message":{"type":"string"},"request_id":{"type":"number"},"status":{"type":"string"},"swatch_count":{"type":"number"}},"required":["request_id","status","estimated_delivery_days","swatch_count","message"],"type":"object"}Free-text search across the full catalogue — use for open queries like 'blockout forPreferredbedroom'free-textordiscovery.'woodReturnsvenetian'.resultsReturnscontainingidproduct_id, name, category, description, product_url andproduct_url.colour_count_in_stock,Forplusfilteringtotalbyandcategory,currency.colour,Fororstructureddimensionsfilters uselookup_catalog instead.lookup_catalog. Passthe returned idproduct_id to get_product or get_price.
before
—after
{"additionalProperties":true,"properties":{"currency":{"const":"ZAR","type":"string"},"results":{"items":{"additionalProperties":true,"properties":{"category":{"type":"string"},"colour_count_in_stock":{"type":"number"},"description":{"type":"string"},"name":{"type":"string"},"product_id":{"type":"string"},"product_url":{"type":"string"}},"required":["product_id","name","category","description","product_url","colour_count_in_stock"],"type":"object"},"type":"array"},"total":{"type":"number"}},"required":["results","total","currency"],"type":"object"}UseLegacywhendiscovery,theretainedcustomerforhasn'tbackwardspecifiedcompatibility.aPreferproductsearch_catalogID/yet.lookup_catalog, then get_product. Filters by blind type(roller,venetian, honeycomb, vertical, outdoor),colourname,or maximumwindowdimensions.dimensionsReturnsinproductsmm.withReturnsid (not product_id), name, description, features,and in-stock colour count. Passthethat id as product_id to get_price orconfigure_product as the next step.configure_product.
before
—after
{"additionalProperties":true,"properties":{"contact_name":{"type":"string"},"contact_phone":{"type":"string"},"note":{"type":"string"},"products":{"items":{"additionalProperties":true,"properties":{"category":{"type":"string"},"colour_count":{"type":"number"},"description":{"type":"string"},"features":{"items":{"type":"string"},"type":"array"},"id":{"type":"string"},"installation_type":{"type":"string"},"materials":{"items":{"type":"string"},"type":"array"},"name":{"type":"string"},"product_url":{"type":"string"},"suitable_for":{"items":{"type":"string"},"type":"array"}},"required":["id","name","category","product_url"],"type":"object"},"type":"array"},"total":{"type":"number"}},"required":["products","total"],"type":"object"}⟨21 unchanged words⟩ :"string"},"message":{"description":"AdditionalRequiredmessageenquiryormessage;questionsatfromleastthe10customercharacters after trimming","minLength":10,"type":"string"},"product_config":{"description" ⟨29 unchanged words⟩ :["product_config","customer_name","customer_email","customer_phone","message"],"type":"object"}
before
—after
{"additionalProperties":true,"properties":{"contact":{"additionalProperties":true,"properties":{"contact_name":{"type":"string"},"contact_phone":{"type":"string"},"email":{"type":"string"},"note":{"type":"string"},"whatsapp":{"type":"string"}},"required":[],"type":"object"},"enquiry_id":{"type":"string"},"message":{"type":"string"},"success":{"type":"boolean"}},"required":["success","enquiry_id","message","contact"],"type":"object"}⟨2 unchanged words⟩ {"type":"string"},"customer":{"properties":{"address":{"type":"string"},"city":{"type":"string"},"email":{"description":"Real customer email, checked before checkout creation","type":"string"},"name":{"description":"Real customer name, checked before checkout creation","type":"string"},"phone":{"description":"South African phone number, checked before checkout creation","type":"string"}},"type":"object"},"indices":{"description":"Item ⟨9 unchanged words⟩ ,"type":"array"},"items":{"items":{"properties":{"colour":{"description":"Exact available colour; validate with configure_product before adding","minLength":1,"type":"string"},"finish":{"description":"Optional pricing finish for aluminium Venetians","type":"string"},"height_mm":{"description":"Actual ordered drop in millimetres","exclusiveMinimum":0,"type":"number"},"mount_type":{"description":"Use inside for recess fit or outside for face fix","minLength":1,"type":"string"},"product_id":{"description":"product_id returned by search_catalog or lookup_catalog","type":"string"},"product_name":{"description":"Optional; server resolves the catalogue name","type":"string"},"quantity":{"description":"Number of blinds; defaults to 1","type":"number"},"total_price_zar":{"description":"Optional, ignored: server recalculates all totals","type":"number"},"unit_price_zar":{"description":"Optional, ignored: server recalculates all prices","type":"number"},"width_mm":{"description":"Actual ordered width in millimetres","exclusiveMinimum":0,"type":"number"}},"required":["product_id","width_mm","height_mm","colour","mount_type"],"type":"object"},"type":"array"},"op":{"default":"set","enum":["add","remove","set" ⟨7 unchanged words⟩
before
—after
{"additionalProperties":true,"properties":{"cart_id":{"type":"string"},"created_at":{"type":"string"},"currency":{"const":"ZAR","type":"string"},"customer":{"anyOf":[{"additionalProperties":true,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"type":"string"},"name":{"type":"string"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":[],"type":"object"},{"type":"null"}]},"expires_at":{"type":"string"},"item_count":{"type":"number"},"items":{"items":{"additionalProperties":true,"properties":{"colour":{"type":"string"},"finish":{"anyOf":[{"type":"string"},{"type":"null"}]},"height_mm":{"type":"number"},"mount_type":{"type":"string"},"product_id":{"type":"string"},"product_name":{"type":"string"},"quantity":{"type":"number"},"total_price_zar":{"type":"number"},"unit_price_zar":{"type":"number"},"width_mm":{"type":"number"}},"required":["product_id","width_mm","height_mm","quantity","unit_price_zar","total_price_zar"],"type":"object"},"type":"array"},"total_zar":{"type":"number"},"updated_at":{"type":"string"}},"required":["cart_id","items","item_count","total_zar","currency","customer","created_at","updated_at","expires_at"],"type":"object"}CorrectUpdate customer details(name, email, phone, address)orswitchpayment_method(yoco | ozow)onlyonbeforeanpayment-linkunpaidgeneration.checkoutPaid,beforecancelledcallingandcomplete_checkout.payment-in-progressReturnscheckoutstheareupdatedrejected.checkoutConcurrentstate.stateRaiseschangesanareerrordetected;ifretrieve thecheckout is alreadylatestpaidstatusorbeforecancelled.retrying.
⟨2 unchanged words⟩ {"type":"string"},"customer":{"properties":{"address":{"type":"string"},"city":{"type":"string"},"email":{"description":"Real customer email, checked before checkout creation","type":"string"},"name":{"description":"Real customer name, checked before checkout creation","type":"string"},"phone":{"description":"South African phone number, checked before checkout creation","type":"string"}},"type":"object"},"payment_method":{"enum" ⟨8 unchanged words⟩
before
—after
{"additionalProperties":true,"properties":{"ap2":{"additionalProperties":true,"properties":{"merchant_authorization":{"type":"string"}},"required":["merchant_authorization"],"type":"object"},"checkout_id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"currency":{"const":"ZAR","type":"string"},"customer":{"additionalProperties":true,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"type":"string"},"name":{"type":"string"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":[],"type":"object"},"item_count":{"type":"number"},"items":{"anyOf":[{"items":{"additionalProperties":true,"properties":{"colour":{"type":"string"},"finish":{"anyOf":[{"type":"string"},{"type":"null"}]},"height":{"type":"number"},"mountType":{"type":"string"},"price":{"type":"number"},"productId":{"type":"string"},"productName":{"type":"string"},"quantity":{"type":"number"},"total":{"type":"number"},"width":{"type":"number"}},"required":[],"type":"object"},"type":"array"},{"type":"null"}]},"message":{"type":"string"},"next_step":{"type":"string"},"payment_method":{"anyOf":[{"type":"string"},{"type":"null"}]},"payment_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"payment_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_reference":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"total_zar":{"type":"number"}},"required":["checkout_id","status","total_zar","currency"],"type":"object"}