Concept Branding

Helper endpoints that return a concept's logo and a ready-made storefront QR code. Both are public, keyed by the concept slug, and return binary/redirect responses (not JSON) — handy for embedding in emails, receipts, signage, and marketing material without holding a token.

Concept Logo

Redirects to the concept's current logo image on the CDN. Because the URL is stable while the underlying image can change, it's safe to hard-code in templates — the redirect always resolves to the latest logo.

GET /v1/ecommerce/concepts/{slug}/logo

Authentication: None (Public)

Rate Limit: 100/min per IP

Path Parameters

Parameter	Type	Description
slug	string	Concept slug (e.g. acme-burgers)

Response

302 Found redirect to the concept's logo URL on the CDN:

HTTP/1.1 302 Found
Location: https://cdn.retailsuccessplatform.com/concepts/.../logo.png?v=1718...

Errors

Status	Condition
404	Concept not found, not active, or has no logo

Concept QR Code

Returns a PNG QR code that links to the concept's ecommerce storefront, optionally branded with the concept's logo and primary color.

GET /v1/ecommerce/concepts/{slug}/qr.png

Authentication: None (Public)

Rate Limit: 100/min per IP

Path Parameters

Parameter	Type	Description
slug	string	Concept slug (e.g. acme-burgers)

Query Parameters

Parameter	Type	Required	Description
size	integer	No	Image size in pixels. Defaults to 400; clamped to 100–1000.

Response

A PNG image:

HTTP/1.1 200 OK
Content-Type: image/png
Cache-Control: public, max-age=3600

The QR encodes the concept's storefront URL. If the concept has a logo it is overlaid in the center, and the concept's brand primary color is used for the modules (defaults to black on white). High error-correction is used so the logo overlay stays scannable.

Errors

Status	Condition
404	Concept not found

---

Changelog

Date	Change
2026-06-17	Initial publication.