UBER-EATS-Wrapper/docs/developer-portal/03-integration-flow.md

Integration Flow

1. Create Merchant

POST /api/v1/merchants

{
  "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. Provision Store Integration (OAuth user token flow)

GET /api/v1/uber/stores/provisionable?merchantId=...

POST /api/v1/uber/stores/{storeId}/pos-data

6. Pull Orders

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

7. Receive Webhooks

POST /api/v1/webhooks/uber

8. Use Generic API for Any Missing Endpoint

POST /api/v1/uber/request

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