# Integration Flow

## 1. Create Merchant

`POST /api/v1/merchants`

```json
{
  "name": "My Restaurant",
  "externalRef": "pos_store_101"
}
```

## 2. Get OAuth URL

`GET /api/v1/auth/uber/authorize-url?merchantId=<merchant_id>`

Redirect merchant to returned URL.

## 3. OAuth Callback

Uber redirects to:

`GET /api/v1/auth/uber/callback?code=...&state=...`

Wrapper stores merchant token.

## 4. Push Menu

`POST /api/v1/uber/menu/upsert`

## 5. Pull Orders

`GET /api/v1/uber/orders?merchantId=...&storeId=...`

## 6. Receive Webhooks

`POST /api/v1/webhooks/uber`

## 7. Use Generic API for Any Missing Endpoint

`POST /api/v1/uber/request`

```json
{
  "merchantId": "<merchant_id>",
  "method": "POST",
  "path": "/v1/eats/some/new/uber/endpoint",
  "body": {}
}
```