GET /api/store/confirm

Request	`GET /api/store/confirm`
Authentication	No authentication
Handler	`backend/server.py`

What it does

Where a sale becomes revenue — by asking the provider, never by trusting the browser that landed on the success URL. The credit lands on the owner recorded when the order was opened. Repeated confirmation of the same reference is one ledger entry, not additional sales.

Authentication

No authentication. The response does not depend on a session.

Parameters

Parameter	In	Type	Required	Description
`ref`	query	`string`	Required	The order reference returned by `POST /api/store/checkout`.

Request

The cookie jar carries the session between calls. Angle-bracketed values are the parameter types from the table above.

cURLJavaScriptPython

curl -s -b cookies.txt -c cookies.txt \
  "https://flowfinds.ai/api/store/confirm?ref=<string>"

const res = await fetch("https://flowfinds.ai/api/store/confirm?ref=<string>", {
  method: "GET",
  credentials: "include",
});
const data = await res.json();

import requests

s = requests.Session()
r = s.get("https://flowfinds.ai/api/store/confirm?ref=<string>")
data = r.json()

Recorded example

curl -s -b cookies.txt -c cookies.txt \
  "$FLOWFINDS_ORIGIN/api/store/confirm?ref=…"

Responses

`200` — The provider confirmed the payment and the ledger was credited.

Errors

Status	Reason	When
`400`	`order_not_found`	No `ref` was supplied.
`404`	`order_not_found`	The provider does not recognise the reference.

GET /api/store — The state of the session's storefront.
POST /api/store — Start generating the storefront for the session's product.
POST /api/store/publish — Verify and publish the storefront, regenerating it if verification demands.
POST /api/intent — Ask the engine what it would change on a surface, and why.
POST /api/intent/apply — Apply a proposed intent, regenerating the store.
POST /api/intent/order — Override the section the storefront leads with.
POST /api/intent/revert — Undo the last applied intent.
POST /api/ai/edit — Edit the storefront in natural language.

Back to the API reference index, or read the cookbook for recipes that compose this endpoint with others.