Examples

Agent

Connect hosted MCP using setup-staging. On VOUCHER_ISSUED, sign with @sohopay/agent-signer and return PAYMENT-SIGNATURE to the merchant. The sequence, including which failures reuse the same idempotency key, is Payment flow. Reference merchant apps in the SohoPay GitHub organization (sohopay-merchant-demo, x402-merchant-demo) show the server side on Base Sepolia. Prefer their capture code over any markdown in those repos that still says POST /settle.

Merchant

curl -X POST https://staging.api.sohopay.xyz/api/v1/facilitator/capture \
  -H "Authorization: Bearer $SOHO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{"x402Version":2,"paymentPayload":{}}'

Replace paymentPayload with the envelope the agent submitted. Then poll GET /api/v1/facilitator/settle/status/by-payment/$PAYMENT_ID until CONFIRMED.

SDKs

Tools

Agent

Merchant

Next steps

Testing

OpenAPI

​Agent

​Merchant

​Next steps

Testing

OpenAPI

Agent

Merchant

Next steps