Skip to content

Facilitator API (Public Surface)

This page defines the external interface only.

Endpoints

POST /verify

Validates x402-compatible payment payloads against current privacy state.

POST /settle

Commits a verified private settlement transition.

GET /health

Returns readiness and version metadata for integration health checks.

Payment Scheme

  • priv-stark/v1

Status Codes

  • 200 success
  • 4xx client validation or policy errors
  • 5xx facilitator or dependency failures

Notes

Field-level schemas and signed examples are released with production hardening gates.

Pre-release documentation. Security-first disclosures only.