# Pages your shop needs

> The pages mongrl's emails link to, and the settings that make the links work.

mongrl sends the emails (sign-in links, confirmations, order and message notices), and their links point at **your** storefront. Build these pages, or the links lead nowhere.

## Set the shop's address first

In the console, **Settings → Shop and emails**: the marketplace's team sets the shop's address (e.g. `https://www.example.com`) and who emails come from. Until the address is set, mongrl can't send emailed links: requesting one gives `409`.

## The pages

`<lang>` is the user's language, lower-case (`sv`, `en`): their `locale`, or the marketplace's default.

| Page | Linked from | What it does |
|---|---|---|
| `/<lang>/auth/sign-in?token=…` | Sign-in links, welcome emails | `POST /v1/sessions/from-link` with the token, store the session, go on to the account. |
| `/<lang>/auth/verify-email?token=…` | Sign-up, "send it again" | `POST /v1/email-verifications` with the token, then say it's confirmed. |
| `/<lang>/auth/reset-password?token=…` | Password reset emails | Ask for a new password, `POST /v1/password-resets/confirm`, then sign in. |
| `/<lang>/orders/<order id>` | Order emails to buyers and sellers | Sign in if needed, then `GET /v1/me/orders/{id}`: state, timeline, buttons from `available_transitions`, delivery booking. |
| `/<lang>/messages/<conversation id>` | New message emails | Sign in if needed, then the conversation. |
| `/<lang>/account/listings/<listing id>` | Valuation offers, denials, listings put on sale | Sign in if needed, then `GET /v1/me/listings/{id}`: the offer to accept or answer, the reason it was denied, or that it's on sale. |

Tokens in links work once. If the page loads twice (a mail scanner, a double click), the second try gets `422`: say the link has been used and offer a new one.

## If your shop doesn't use language prefixes

Redirect them. A shop in one language can send `/en/…` to `/…` and keep the query string, so every emailed link still lands.

## Everything else is yours

Shop, search, listing, brand and designer pages, checkout, the account, selling: their addresses are up to you. Keep them stable, because listing URLs get shared and indexed.