# BipBip Merchant Integration API

> Integration API for merchants: an inbound REST API to manage orders and outbound HMAC-signed webhooks that deliver order and menu events to your POS. Base URLs: https://merchant-api.bipbip.dev (staging), https://merchant-api.bipbip.hn (production). Payload schema version is 1.0.

## Docs
- [Quickstart](/llms/quickstart.txt): Overview of both API surfaces, base URLs, required REST headers, and the end-to-end happy path.
- [REST API](/llms/rest-api.txt): Inbound REST endpoints (Orders + menu), idempotency, rate limits, and the RFC 7807 error envelope.
- [Webhooks](/llms/webhooks.txt): Transport contract, HMAC verification, signed headers, auth strategies, retries, and every event type.
- [Schemas](/llms/schemas.txt): Field-by-field JSON payload schemas for orders, status updates, and menu-change results.
- [Changelog](/llms/changelog.txt): Dated contract changes classified as breaking, behavior, or additive, each with the action it requires. Read this before assuming a field, status, or filter still behaves the way an older integration expects.

## Full context
- [Full context (single file)](/llms-full.txt): Every section concatenated into one file for pasting into an LLM.