South Africa's first AI-transactable blinds, shutters and awnings catalogue with live ZAR pricing.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer token — only for submit_enquiry and create_order. Catalogue and pricing tools are open.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Permanently delete a cart by cart_id. Use when the customer abandons the session or wants to start over. Has no effect on any checkout or paid order already created from this cart. Irreversible, create a new cart to restart.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Permanently delete a cart by cart_id. Use when the customer abandons the session or wants to start over. Has no effect on any checkout or paid order already created from this cart. Irreversible, create a new cart to restart.
| Argument | Type | Description |
|---|---|---|
| cart_id* | string |
{
"type": "object",
"required": [
"cart_id"
],
"properties": {
"cart_id": {
"type": "string"
}
}
}Abort an unpaid checkout and release its checkout_id. Use if the customer changes their mind after create_checkout but before completing payment. Has no effect on orders already confirmed by webhook. To restart, create a new cart and checkout from scratch.
| Argument | Type | Description |
|---|---|---|
| checkout_id* | string |
{
"type": "object",
"required": [
"checkout_id"
],
"properties": {
"checkout_id": {
"type": "string"
}
}
}Verify whether a specific colour is available before configure_product. Returns in_stock boolean, expected_restock_date if out of stock, and up to 5 alternative in-stock colours ordered by similarity. Call this when a customer requests a named colour or when you want to prevent a configure_product failure due to an out-of-stock selection.
| Argument | Type | Description |
|---|---|---|
| product_id* | string | |
| colour_name* | string |
{
"type": "object",
"required": [
"product_id",
"colour_name"
],
"properties": {
"product_id": {
"type": "string"
},
"colour_name": {
"type": "string"
}
}
}Generate a Yoco card or Ozow instant-EFT payment link; this does NOT complete payment. Rejects cancelled checkouts and rechecks stock and totals first. An atomic claim prevents competing gateway calls. Returns payment_url or null plus status and message; cloud callers may be held. Retain a successful URL: repeat calls return payment_pending with no URL. Gateway failures raise an error, send no payment-link email and require team review rather than an automatic retry. Poll get_order with customer_email for payment status.
| Argument | Type | Description |
|---|---|---|
| checkout_id* | string | |
| payment_method | string | Overrides any value set in create_checkout/update_checkout |
{
"type": "object",
"required": [
"checkout_id"
],
"properties": {
"checkout_id": {
"type": "string"
},
"payment_method": {
"enum": [
"yoco",
"ozow"
],
"type": "string",
"description": "Overrides any value set in create_checkout/update_checkout"
}
}
}Lock in a full blind specification: product, dimensions, colour, and mount type (inside recess or outside face-fix). Validates that the colour exists and is in stock, then prices the blind. Returns a configuration summary to pass directly into create_cart. Call check_colour_stock first if availability is uncertain.
| Argument | Type | Description |
|---|---|---|
| colour* | string | Colour name (must match available colours) |
| finish | string | Optional finish for aluminium venetians |
| province | string | Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact. |
| quantity | number | Number of blinds (default 1) |
| width_mm* | number | Width in millimetres |
| height_mm* | number | Height/drop in millimetres |
| mount_type* | string | Use inside (recess) or outside (face-fix); handler requires a nonempty value |
| product_id* | string | product_id from search_catalog or lookup_catalog |
Start the open UCP purchase flow, no auth needed. Creates a cart session and returns a cart_id (24-hour TTL). Optionally seed with pre-configured blind items and customer details. Next step: update_cart to add items, then create_checkout → complete_checkout to mint the payment link.
| Argument | Type | Description |
|---|---|---|
| items | array | Optional configured items; all submitted prices are ignored |
| customer | object |
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"product_id",
"width_mm",
"height_mm",
"colour",
"mount_type"
],
"properties": {
"colour": {
"type": "string",
"minLength": 1,
"description": "Exact available colour; validate with configure_product before adding"
},
"finish": {
"type": "string",
"description": "Optional pricing finish for aluminium Venetians"
},
"quantity": {
"type": "number",
"description": "Number of blinds; defaults to 1"
},
"width_mm": {
"type": "number",
"description": "Actual ordered width in millimetres",
"exclusiveMinimum": 0
},
"height_mm": {
"type": "number",
"description": "Actual ordered drop in millimetres",
"exclusiveMinimum": 0
},
"mount_type": {
"type": "string",
"minLength": 1,
"description": "Use inside for recess fit or outside for face fix"
},
"product_id": {
"type": "string",
"description": "product_id returned by search_catalog or lookup_catalog"
},
"product_name": {
"type": "string",
"description": "Optional; server resolves the catalogue name"
},
"unit_price_zar": {
"type": "number",
"description": "Optional, ignored: server recalculates all prices"
},
"total_price_zar": {
"type": "number",
"description": "Optional, ignored: server recalculates all totals"
}
}
},
"description": "Optional configured items; all submitted prices are ignored"
},
"customer": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"name": {
"type": "string",
"description": "Real customer name, checked before checkout creation"
},
"email": {
"type": "string",
"description": "Real customer email, checked before checkout creation"
},
"phone": {
"type": "string",
"description": "South African phone number, checked before checkout creation"
},
"address": {
"type": "string"
}
}
}
}
}Phase 1 of 2 in the purchase flow. Convert a cart (or inline items + customer) into a checkout. The customer's real name, email, mobile number and delivery address are required; placeholder or test details are refused. Returns checkout_id. No payment link is minted yet, call complete_checkout for that. Use update_checkout to correct customer details before finalising.
| Argument | Type | Description |
|---|---|---|
| items | array | |
| cart_id | string | Either cart_id or items required |
| customer | object | |
| payment_method | string | Default 'yoco' |
{
"type": "object",
"anyOf": [
{
"required": [
"cart_id"
]
},
{
"required": [
"items",
"customer"
],
"properties": {
"customer": {
"required": [
"name",
"email",
"phone"
]
}
}
}
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"product_id",
"width_mm",
"height_mm",
"colour",
"mount_type"
],
"properties": {
"colour": {
"type": "string",
"minLength": 1,
"description": "Exact available colour; validate with configure_product before adding"
},
"finish": {
"type": "string",
"description": "Optional pricing finish for aluminium Venetians"
},
"quantity": {
"type": "number",
"description": "Number of blinds; defaults to 1"
},
"width_mm": {
"type": "number",
"description": "Actual ordered width in millimetres",
"exclusiveMinimum": 0
},
"height_mm": {
"type": "number",
"description": "Actual ordered drop in millimetres",
"exclusiveMinimum": 0
},
"mount_type": {
"type": "string",
"minLength": 1,
"description": "Use inside for recess fit or outside for face fix"
},
"product_id": {
"type": "string",
"description": "product_id returned by search_catalog or lookup_catalog"
},
"product_name": {
"type": "string",
"description": "Optional; server resolves the catalogue name"
},
"unit_price_zar": {
"type": "number",
"description": "Optional, ignored: server recalculates all prices"
},
"total_price_zar": {
"type": "number",
"description": "Optional, ignored: server recalculates all totals"
}
}
},
"minItems": 1
},
"cart_id": {
"type": "string",
"description": "Either cart_id or items required"
},
"customer": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"name": {
"type": "string",
"description": "Real customer name, checked before checkout creation"
},
"email": {
"type": "string",
"description": "Real customer email, checked before checkout creation"
},
"phone": {
"type": "string",
"description": "South African phone number, checked before checkout creation"
},
"address": {
"type": "string"
}
}
},
"payment_method": {
"enum": [
"yoco",
"ozow"
],
"type": "string",
"description": "Default 'yoco'"
}
}
}Legacy auth-required tool, prefer the open UCP flow (create_cart → create_checkout → complete_checkout) which needs no credentials. Use create_order only if you hold a Bearer token and want a single-call path to a payment link. All item prices are re-verified server-side against the live pricing engine, agent-supplied prices are ignored. Returns a Yoco or Ozow payment_url.
| Argument | Type | Description |
|---|---|---|
| items* | array | Array of configured blind items |
| customer_city | string | Delivery city |
| customer_name* | string | Customer full name |
| customer_email* | string | Customer email address |
| customer_phone* | string | Customer phone number |
| payment_method | string | Yoco card or Ozow instant EFT |
| customer_address | string | Delivery address |
{
"type": "object",
"required": [
"items",
"customer_name",
"customer_email",
"customer_phone"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"product_id",
"width_mm",
"height_mm",
"colour",
"mount_type"
],
"properties": {
"colour": {
"type": "string"
},
"finish": {
"type": "string"
},
"quantity": {
"type": "number"
},
"width_mm": {
"type": "number"
},
"height_mm": {
"type": "number"
},
"mount_type": {
"type": "string"
},
"product_id": {
"type": "string"
},
"product_name": {
"type": "string"
},
"unit_price_zar": {
"type": "number"
},
"total_price_zar": {
"type": "number"
}
}
},
"minItems": 1,
"description": "Array of configured blind items"
},
"customer_city": {
"type": "string",
"description": "Delivery city"
},
"customer_name": {
"type": "string",
"description": "Customer full name"
},
"customer_email": {
"type": "string",
"description": "Customer email address"
},
"customer_phone": {
"type": "string",
"description": "Customer phone number"
},
"payment_method": {
"enum": [
"yoco",
"ozow"
],
"type": "string",
"default": "yoco",
"description": "Yoco card or Ozow instant EFT"
},
"customer_address": {
"type": "string",
"description": "Delivery address"
}
}
}Returns the link to the Custom Blinds measuring guide when a customer is unsure how to measure. There is no AR tool: the guide shows how to measure for an inside (recess) or outside (face fix) fit in two minutes, and a customer who is still unsure can order with best guess sizes, receive a free tape measure and confirm before production starts.
| Argument | Type | Description |
|---|---|---|
| mode | string | Which tool to surface. Default: both. |
| product_id | string | Optional. Pre-select a product in the visualizer (e.g. roller-blockout, venetian-25mm-aluwood). |
{
"type": "object",
"properties": {
"mode": {
"enum": [
"measure",
"visualize",
"both"
],
"type": "string",
"description": "Which tool to surface. Default: both."
},
"product_id": {
"type": "string",
"description": "Optional. Pre-select a product in the visualizer (e.g. roller-blockout, venetian-25mm-aluwood)."
}
}
}Retrieve live cart state by cart_id: full item list, calculated totals in ZAR, and any customer details stored so far. Call after update_cart to confirm changes are correct before proceeding to create_checkout. Cart expires after 24 hours of inactivity.
| Argument | Type | Description |
|---|---|---|
| cart_id* | string |
{
"type": "object",
"required": [
"cart_id"
],
"properties": {
"cart_id": {
"type": "string"
}
}
}Read checkout by checkout_id. Returns persisted order status, payment_status, payment_method, items, customer, total_zar and currency. Initial order status is started, not pending. This tool does not return a previously generated payment_url: retain the complete_checkout response in caller context.
| Argument | Type | Description |
|---|---|---|
| checkout_id* | string |
{
"type": "object",
"required": [
"checkout_id"
],
"properties": {
"checkout_id": {
"type": "string"
}
}
}Explain the production lead time for a new order. Production takes 5 to 7 working days, excluding transit times and outside peak seasons. Returns dispatch_date, production_days, and a plain-language summary safe to share with the customer. Never quote a final delivery date. Call this when a customer asks 'when will it arrive?' to give an honest production timeline.
| Argument | Type | Description |
|---|---|---|
| order_date | string | ISO date string of the order placement date (e.g. '2026-05-18'). Defaults to today. |
{
"type": "object",
"properties": {
"order_date": {
"type": "string",
"description": "ISO date string of the order placement date (e.g. '2026-05-18'). Defaults to today."
}
}
}Retrieve a confirmed order's status, items, and payment details by order_id. customer_email is required as soft-auth and must exactly match the order record, prevents arbitrary order lookups. Returns payment status (paid | pending | failed), production status, and dispatch date once available.
| Argument | Type | Description |
|---|---|---|
| order_id* | string | |
| customer_email* | string |
{
"type": "object",
"required": [
"order_id",
"customer_email"
],
"properties": {
"order_id": {
"type": "string"
},
"customer_email": {
"type": "string"
}
}
}List available payment processors and their capabilities. Returns Yoco (card, immediate) and Ozow (instant EFT via South African bank account). Call when the customer asks 'how can I pay?' or before presenting options. The result informs the payment_method field in create_checkout and complete_checkout.
| Argument | Type | Description |
|---|---|---|
| order_total_zar | number | Optional. For future per-handler limit filtering. |
{
"type": "object",
"properties": {
"order_total_zar": {
"type": "number",
"description": "Optional. For future per-handler limit filtering."
}
}
}Get an exact ZAR price using product_id from search_catalog or lookup_catalog, width_mm and height_mm. Prices include VAT and delivery. Colour selects the bamboo price tier where applicable. A price is not a stock reservation: validate the exact colour and mount with configure_product before creating a cart. Failure can return success:false or a JSON-RPC validation error.
| Argument | Type | Description |
|---|---|---|
| colour | string | Optional bamboo colour for colour-specific tier pricing |
| finish | string | Optional finish for aluminium products: Plain, Brushed, Woodgrain |
| province | string | Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact. |
| quantity | number | Number of blinds (default 1) |
| width_mm* | number | Width in millimetres (e.g. 1200) |
| height_mm* | number | Height/drop in millimetres (e.g. 1500) |
| product_id* | string | product_id from search_catalog or lookup_catalog (e.g. roller-blockout) |
Fetch complete details for one product by id (e.g. roller-blockout, venetian-25mm-aluwood). Returns all available colours with in-stock status, materials, features, and maximum supported dimensions. Use before configure_product to confirm a colour exists and is in stock before committing.
| Argument | Type | Description |
|---|---|---|
| product_id* | string |
{
"type": "object",
"required": [
"product_id"
],
"properties": {
"product_id": {
"type": "string"
}
}
}Translate a customer's primary concern into a product recommendation. primary_concern must be one of: blockout, heat, glare, moisture, privacy, security, automation. Optionally narrow by room (bedroom, lounge, etc.), location, budget, and aesthetic. Returns a recommended product_id with rationale, pass it to get_price or configure_product next. Security concern routes to brochure MCP (Garden Route customers only).
| Argument | Type | Description |
|---|---|---|
| room | string | |
| location | string | |
| aesthetic | string | |
| max_budget_zar | number | |
| primary_concern* | string |
{
"type": "object",
"required": [
"primary_concern"
],
"properties": {
"room": {
"type": "string"
},
"location": {
"type": "string"
},
"aesthetic": {
"type": "string"
},
"max_budget_zar": {
"type": "number"
},
"primary_concern": {
"enum": [
"blockout",
"heat",
"glare",
"moisture",
"privacy",
"security",
"automation"
],
"type": "string"
}
}
}Generate a pre-filled WhatsApp deep link to hand the customer off to the right contact. Garden Route locations (Knysna, Plett, George, Sedgefield, etc.) route to Duncan Kane for a free in-home consultation, booked on the same WhatsApp line (+27760228410); all other South African locations route to that line too (+27760228410). It is WhatsApp only, no voice calls. Use when the customer prefers human assistance or when self-serve checkout isn't appropriate.
| Argument | Type | Description |
|---|---|---|
| message | string | Optional additional message to prefill |
| location | string | City/suburb. Drives Duncan vs shop routing. |
| customer_name | string | |
| product_context | string | e.g. 'roller blockout for bedroom' |
{
"type": "object",
"properties": {
"message": {
"type": "string",
"description": "Optional additional message to prefill"
},
"location": {
"type": "string",
"description": "City/suburb. Drives Duncan vs shop routing."
},
"customer_name": {
"type": "string"
},
"product_context": {
"type": "string",
"description": "e.g. 'roller blockout for bedroom'"
}
}
}Preferred structured discovery. Filter by category, partial colour name or required supported width/drop in mm. Returns results containing product_id, name, category and product_url, plus total. Width/drop filters check separate maximums, not every combination; confirm the exact pair with get_price.
| Argument | Type | Description |
|---|---|---|
| colour | string | |
| category | string | roller | venetian | honeycomb | vertical | outdoor |
| max_width_mm | number | |
| max_height_mm | number |
{
"type": "object",
"properties": {
"colour": {
"type": "string"
},
"category": {
"type": "string",
"description": "roller | venetian | honeycomb | vertical | outdoor"
},
"max_width_mm": {
"type": "number"
},
"max_height_mm": {
"type": "number"
}
}
}Submit a price match claim when the customer has found the same blind at a lower price elsewhere. Custom Blinds matches verified South African retailer prices for identical product, dimensions, and specs. Returns a pre-filled WhatsApp link to the claims team. Not applicable to: clearance or flash-sale prices, or out-of-stock items. Requires product_id and competitor_price_zar at minimum.
| Argument | Type | Description |
|---|---|---|
| width_mm | number | Window width in mm |
| height_mm | number | Window height/drop in mm |
| product_id* | string | Product the customer wants to match (e.g. roller-blockout) |
| customer_name | string | Customer name |
| competitor_url | string | URL to competitor product page or quote |
| competitor_name | string | Name of the competitor (e.g. 'Blind Empire') |
| customer_whatsapp | string | Customer WhatsApp number for follow-up |
| competitor_price_zar* | number | Competitor's price in ZAR (incl. VAT) |
Log up to 5 colour codes against an EXISTING order for the team (order_ref required; without it the tool returns status order_required and logs nothing). Custom Blinds does not post individual swatches or off-cuts. For orders over R8,000 the customer can ask for the full sample book via WhatsApp; if nothing suits, full refund with no fees. Never quote a sample-book price or courier cost.
| Argument | Type | Description |
|---|---|---|
| suburb | string | Optional delivery suburb |
| order_ref* | string | The order reference the swatches ship with. Required. |
| swatch_codes | array | Optional specific colour codes (max 5) |
| customer_name* | string | |
| customer_email* | string | |
| customer_phone* | string | Used as WhatsApp number |
| product_interest* | string | e.g. 'Roller Blockout' or 'Honeycomb' |
{
"type": "object",
"required": [
"customer_name",
"customer_email",
"customer_phone",
"product_interest",
"order_ref"
],
"properties": {
"suburb": {
"type": "string",
"description": "Optional delivery suburb"
},
"order_ref": {
"type": "string",
"description": "The order reference the swatches ship with. Required."
},
"swatch_codes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional specific colour codes (max 5)"
},
"customer_name": {
"type": "string"
},
"customer_email": {
"type": "string"
},
"customer_phone": {
"type": "string",
"description": "Used as WhatsApp number"
},
"product_interest": {
"type": "string",
"description": "e.g. 'Roller Blockout' or 'Honeycomb'"
}
}
}Preferred free-text discovery. Returns results containing product_id, name, category, description, product_url and colour_count_in_stock, plus total and currency. For structured filters use lookup_catalog. Pass product_id to get_product or get_price.
| Argument | Type | Description |
|---|---|---|
| query | string | Free-text query, e.g. 'blockout' or 'venetian' |
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Free-text query, e.g. 'blockout' or 'venetian'"
}
}
}Legacy discovery, retained for backward compatibility. Prefer search_catalog / lookup_catalog, then get_product. Filters by blind type, colour or maximum dimensions. Returns products with id (not product_id), name, description, features and in-stock colour count. Pass that id as product_id to get_price or configure_product.
| Argument | Type | Description |
|---|---|---|
| type | string | Blind category to filter by: roller, venetian, honeycomb, vertical, outdoor |
| colour | string | Colour name to search for (partial match) |
| province | string | Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact. |
| max_width_mm | number | Maximum width in millimetres the product supports |
| max_height_mm | number | Maximum height/drop in millimetres the product supports |
{
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Blind category to filter by: roller, venetian, honeycomb, vertical, outdoor"
},
"colour": {
"type": "string",
"description": "Colour name to search for (partial match)"
},
"province": {
"type": "string",
"description": "Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact."
},
"max_width_mm": {
"type": "number",
"description": "Maximum width in millimetres the product supports"
},
"max_height_mm": {
"type": "number",
"description": "Maximum height/drop in millimetres the product supports"
}
}
}Legacy auth-required tool, prefer the open UCP flow (create_cart → create_checkout → complete_checkout) for credentialless checkout. Use submit_enquiry only when the customer wants a sales team follow-up by email rather than paying online. Requires Bearer token. Pass a configure_product output plus customer name, email, and phone. Team responds within 24 hours.
| Argument | Type | Description |
|---|---|---|
| message* | string | Required enquiry message; at least 10 characters after trimming |
| customer_name* | string | Customer full name |
| customer_email* | string | Customer email address |
| customer_phone* | string | Customer phone number |
| product_config* | object | Product configuration from configure_product |
{
"type": "object",
"required": [
"product_config",
"customer_name",
"customer_email",
"customer_phone",
"message"
],
"properties": {
"message": {
"type": "string",
"minLength": 10,
"description": "Required enquiry message; at least 10 characters after trimming"
},
"customer_name": {
"type": "string",
"description": "Customer full name"
},
"customer_email": {
"type": "string",
"description": "Customer email address"
},
"customer_phone": {
"type": "string",
"description": "Customer phone number"
},
"product_config": {
"type": "object",
"properties": {
"colour": {
"type": "string"
},
"width_mm": {
"type": "number"
},
"height_mm": {
"type": "number"
},
"price_zar": {
"type": "number"
},
"mount_type": {
"type": "string"
},
"product_id": {
"type": "string"
},
"product_name": {
"type": "string"
}
},
"description": "Product configuration from configure_product"
}
}
}Modify an open cart before checkout. op: 'add' appends items, 'remove' drops items by 0-based index, 'set' replaces the full item list, 'clear' empties the cart. Merges customer details (name, email, phone) via the customer field. Call get_cart afterwards to confirm. Cannot modify a cart that already has a checkout in progress.
| Argument | Type | Description |
|---|---|---|
| op | string | |
| items | array | |
| cart_id* | string | |
| indices | array | Item indices to remove (0-based) when op='remove' |
| customer | object |
{
"type": "object",
"required": [
"cart_id"
],
"properties": {
"op": {
"enum": [
"add",
"remove",
"set",
"clear"
],
"type": "string",
"default": "set"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"product_id",
"width_mm",
"height_mm",
"colour",
"mount_type"
],
"properties": {
"colour": {
"type": "string",
"minLength": 1,
"description": "Exact available colour; validate with configure_product before adding"
},
"finish": {
"type": "string",
"description": "Optional pricing finish for aluminium Venetians"
},
"quantity": {
"type": "number",
"description": "Number of blinds; defaults to 1"
},
"width_mm": {
"type": "number",
"description": "Actual ordered width in millimetres",
"exclusiveMinimum": 0
},
"height_mm": {
"type": "number",
"description": "Actual ordered drop in millimetres",
"exclusiveMinimum": 0
},
"mount_type": {
"type": "string",
"minLength": 1,
"description": "Use inside for recess fit or outside for face fix"
},
"product_id": {
"type": "string",
"description": "product_id returned by search_catalog or lookup_catalog"
},
"product_name": {
"type": "string",
"description": "Optional; server resolves the catalogue name"
},
"unit_price_zar": {
"type": "number",
"description": "Optional, ignored: server recalculates all prices"
},
"total_price_zar": {
"type": "number",
"description": "Optional, ignored: server recalculates all totals"
}
}
}
},
"cart_id": {
"type": "string"
},
"indices": {
"type": "array",
"items": {
"type": "number"
},
"description": "Item indices to remove (0-based) when op='remove'"
},
"customer": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"name": {
"type": "string",
"description": "Real customer name, checked before checkout creation"
},
"email": {
"type": "string",
"description": "Real customer email, checked before checkout creation"
},
"phone": {
"type": "string",
"description": "South African phone number, checked before checkout creation"
},
"address": {
"type": "string"
}
}
}
}
}Update customer details or payment_method only before payment-link generation. Paid, cancelled and payment-in-progress checkouts are rejected. Concurrent state changes are detected; retrieve the latest status before retrying.
| Argument | Type | Description |
|---|---|---|
| customer | object | |
| checkout_id* | string | |
| payment_method | string |
{
"type": "object",
"required": [
"checkout_id"
],
"properties": {
"customer": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"name": {
"type": "string",
"description": "Real customer name, checked before checkout creation"
},
"email": {
"type": "string",
"description": "Real customer email, checked before checkout creation"
},
"phone": {
"type": "string",
"description": "South African phone number, checked before checkout creation"
},
"address": {
"type": "string"
}
}
},
"checkout_id": {
"type": "string"
},
"payment_method": {
"enum": [
"yoco",
"ozow"
],
"type": "string"
}
}
}{
"type": "object",
"required": [
"product_id",
"width_mm",
"height_mm",
"colour",
"mount_type"
],
"properties": {
"colour": {
"type": "string",
"description": "Colour name (must match available colours)"
},
"finish": {
"type": "string",
"description": "Optional finish for aluminium venetians"
},
"province": {
"type": "string",
"description": "Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact."
},
"quantity": {
"type": "number",
"description": "Number of blinds (default 1)"
},
"width_mm": {
"type": "number",
"description": "Width in millimetres"
},
"height_mm": {
"type": "number",
"description": "Height/drop in millimetres"
},
"mount_type": {
"type": "string",
"minLength": 1,
"description": "Use inside (recess) or outside (face-fix); handler requires a nonempty value"
},
"product_id": {
"type": "string",
"description": "product_id from search_catalog or lookup_catalog"
}
}
}{
"type": "object",
"required": [
"product_id",
"width_mm",
"height_mm"
],
"properties": {
"colour": {
"type": "string",
"description": "Optional bamboo colour for colour-specific tier pricing"
},
"finish": {
"type": "string",
"description": "Optional finish for aluminium products: Plain, Brushed, Woodgrain"
},
"province": {
"type": "string",
"description": "Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact."
},
"quantity": {
"type": "number",
"description": "Number of blinds (default 1)"
},
"width_mm": {
"type": "number",
"description": "Width in millimetres (e.g. 1200)"
},
"height_mm": {
"type": "number",
"description": "Height/drop in millimetres (e.g. 1500)"
},
"product_id": {
"type": "string",
"description": "product_id from search_catalog or lookup_catalog (e.g. roller-blockout)"
}
}
}{
"type": "object",
"required": [
"product_id",
"competitor_price_zar"
],
"properties": {
"width_mm": {
"type": "number",
"description": "Window width in mm"
},
"height_mm": {
"type": "number",
"description": "Window height/drop in mm"
},
"product_id": {
"type": "string",
"description": "Product the customer wants to match (e.g. roller-blockout)"
},
"customer_name": {
"type": "string",
"description": "Customer name"
},
"competitor_url": {
"type": "string",
"description": "URL to competitor product page or quote"
},
"competitor_name": {
"type": "string",
"description": "Name of the competitor (e.g. 'Blind Empire')"
},
"customer_whatsapp": {
"type": "string",
"description": "Customer WhatsApp number for follow-up"
},
"competitor_price_zar": {
"type": "number",
"description": "Competitor's price in ZAR (incl. VAT)"
}
}
}