Use staging for Protocol V2 integration today (Base Sepolia). Production hosts exist in infra; settlement and contract addresses are issued when your account is cut over. Do not point payment traffic at production until SohoPay confirms cutover.
Do not use api-sandbox.sohopay.xyz. That host is not the current API.
Production settlement (Protocol V2 on Base mainnet) is not enabled for general integrators yet. The production column below is for hostnames and future cutover planning only.

Hosts

Edit hostnames in config/hosts.json in this repo, then run node deploy/sync-hosts.mjs so MDX variables and the OpenAPI server list stay in sync.
Staging API DNS is staging.api.sohopay.ai (staging before the service label), not api.staging.sohopay.ai. The facilitator base is https://staging.api.sohopay.ai/api/v1/facilitator.
Facilitator routes:
  • Staging: https://staging.api.sohopay.ai/api/v1/facilitator/
  • Production: https://api.sohopay.ai/api/v1/facilitator/

Chain and token

Protocol V1 SohoSettlement is not deployed on staging. Explorer: sepolia.basescan.org.

What you install

Agents need a host that speaks remote MCP (Cursor, Claude, or another OAuth-capable client) and, for signing, @sohopay/agent-signer. Merchants need an HTTP client that can POST the capture body and poll status. Neither path needs a SohoPay REST SDK.

Next steps

Authentication

OAuth scopes and merchant API keys.

Quickstart

Run the agent or merchant track.