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

# Integration paths

> Choose the agent MCP path, the merchant facilitator path, or both.

Most integrations are one of two callers. A product that both spends and charges implements both, and they stay separate: the agent never calls the facilitator, and the merchant never calls `prepare_x402_payment`.

## Agent

You are an agent host, or you are embedding SohoPay so an agent can buy APIs, data, or compute.

1. Connect hosted MCP. [Agent setup](/guides/agent-setup.md).
2. Finish borrower onboarding, including the wallet proof, the agent grant, and a handle. [Borrower onboarding](/guides/borrower-onboarding.md).
3. On each HTTP 402, prepare, sign, and retry. [Payment flow](/guides/payment-flow.md).
4. When the borrower wants to pay the facility down, open the repay consent URL. [Repayment](/guides/repayment.md).

The behavior contract for agents is the skill set at `https://agents.sohopay.ai/skills/v1/`. These docs describe the same flow without replacing those skills.

## Merchant

You run a resource server that should charge agents.

1. Get a merchant account. [Merchant onboarding](/guides/merchant-onboarding.md).
2. Return 402, then verify and capture the voucher. [Merchant integration](/guides/merchant-integration.md).
3. Poll until `CONFIRMED` before you fulfill. [Settlements](/guides/settlements-payouts.md).

Your merchant must be `ACTIVE` in [SohoMerchantRegistry](/guides/allowlist-management.md). The fee on a captured payment is deducted from your payout. See [Fees](/compliance/fees.md).

## What we do not offer as an integration path

* A REST SDK (`@sohopay/sdk`, `sohopay` on PyPI) that creates agents and orders.
* An operator API that deposits vault collateral and then provisions MPC wallets.
* A local stdio MCP server you clone and run.
* Merchant settlement webhooks. You poll.

## Next steps

> [card] [Quickstart](/quickstart.md)
>
> The shortest version of each path.

> [card] [Protocol: x402](/protocol/x402.md)
>
> What the 402 body and the voucher mean.
