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

# OpenAPI tools

> Generate a merchant client from the facilitator OpenAPI document.

The spec at [openapi.json](/api-reference/openapi.json) covers the facilitator only: verify, capture, and the two status polls, plus discovery and health. It does not describe MCP tools. Generate clients from that file if you want typed merchant calls. Hand-written HTTP is enough for capture and poll. See [Merchant integration](/guides/merchant-integration.md).

```bash
npx @openapitools/openapi-generator-cli generate \
  -i api-reference/openapi.json \
  -g typescript-fetch \
  -o generated/facilitator
```

Point the generated client at `https://staging.api.sohopay.ai/api/v1` (staging) or `https://api.sohopay.ai/api/v1` (production, after cutover) and send the merchant bearer token. Keep using one `Idempotency-Key` per capture.

> [!NOTE]
>
> Do not generate against an older spec that listed `/agents`, `/orders`, or `/vault`. Those routes are not the integrator API.

## Next steps

> [card] [API reference](/api-reference/introduction.md)
>
> What each route is for.

> [card] [Examples](/sdks/examples.md)
>
> A capture call without a generator.
