> ## Documentation Index
> Fetch the complete documentation index at: https://developers.xfaster.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Restaurant setup

> Credentials and environments.

<Steps>
  <Step title="Ask for a sandbox key">
    Email XFaster with your company name and an HTTPS endpoint for webhooks. You get an `xfp_test_…` key and a `whsec_…` webhook secret for the test store, shown once.
  </Step>

  <Step title="Receive webhooks">
    Verify the signature ([Webhooks](/basics/webhooks)), answer `2xx` within 5 seconds, then fetch the order.
  </Step>

  <Step title="Send or map the menu">
    Send your POS menu with [Import the menu](/restaurant/menu/import) (or host it: [POS-hosted mode](/restaurant/pos-hosted)). A store that keeps its XFaster menu links its items to your codes instead ([Map your codes](/restaurant/menu/mapping)). Your codes then come in every order line as `external_id`.
  </Step>

  <Step title="Run the checklist">
    Pass the [go-live checklist](/restaurant/checklist). XFaster then creates a live key for each store that uses your POS.
  </Step>
</Steps>

## Environments

| | Base URL | Key |
| - | - | - |
| Sandbox | `https://staging2.xfaster.net/api/partner/v1` | `xfp_test_…` |
| Live | `https://apps.xfaster.net/api/partner/v1` | `xfp_live_…` |

## Choices, add-ons and deals

* **`choices`** are the customer's answers to option groups (size, doneness). Match them by `group` + `option` text.
* **`addons`** carry `addon_id`, your `external_id`, quantity and price.
* **`components`** list what is inside a deal or a pizza, ready to print.
* **`unit_price`** includes the chosen options. `total` = (`unit_price` + add-ons) × `quantity`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.