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

# API reference

> The public merchant HTTP API is the facilitator. Agents integrate through hosted MCP, not these routes.

Two integrations, two surfaces.

**Agents** call hosted MCP (`https://staging.mcp.sohopay.ai/mcp` on staging, `https://mcp.sohopay.ai/mcp` after cutover). Tool names and sequences live in the skills at `https://agents.sohopay.ai/skills/v1/` and in [Payment flow](/guides/payment-flow.md). They are not REST resources in this reference.

**Merchants** call the facilitator base (`https://staging.api.sohopay.ai/api/v1/facilitator` on staging, `https://api.sohopay.ai/api/v1/facilitator` after cutover) with a merchant JWT or an `sk_live_` API key. The OpenAPI document next to this page lists those routes only.

| Method and path | Purpose |
| - | - |
| `POST /facilitator/verify` | Check a version-2 credit envelope. Does not capture. |
| `POST /facilitator/capture` | Queue the payment and return a signed receipt. Send `Idempotency-Key`. |
| `GET /facilitator/settle/status/by-payment/{paymentId}` | Poll by the receipt's `paymentId`. |
| `GET /facilitator/settle/status/{jobId}` | Poll by the batch confirmation job id, once one exists. |
| `GET /facilitator/supported` | Scheme, version, network, and asset. |
| `GET /facilitator/health` | Liveness. |

There is no `POST /facilitator/settle`. Settlement is the scheduled batch.

> [!NOTE]
>
> Use this reference for anything you ship. These pages are the facilitator contract.

## Next steps

> [card] [Merchant integration](/guides/merchant-integration.md)
>
> How to form the capture body.

> [card] [Errors](/api-reference/errors.md)
>
> Codes those routes return.
