Documentation

HTTP + x402

Use the six-operation public API and follow binding payment terms from the live challenge.

Discovery is inert

An unsigned invocation request returns x402 v2 payment requirements. Discovery does not settle, admit work, allocate an artifact, or create a receipt.

Retry the same purchase

After authorization, retry the exact request with the same idempotency key and payment material. Changed input, terms, requirements, or identity are refused before settlement.

  • PAYMENT-REQUIRED describes the current external payment challenge.
  • PAYMENT-SIGNATURE carries buyer authorization on the paid retry.
  • PAYMENT-RESPONSE carries settlement evidence; it does not itself prove fulfilment.

Public operations

These six operations are generated from the current OpenAPI authority.

GET /v1/offers Search immutable offers SearchOffers
GET /v1/offers/{offer_id} Resolve an active or pinned offer revision GetOffer
POST /v1/invocations/prepare Validate invocation input and return binding terms PrepareInvocation
POST /v1/invocations Admit or replay one invocation InvokeOffer
GET /v1/invocations/{invocation_id} Read authoritative invocation state GetInvocation
POST /v1/invocations/{invocation_id}/cancel Request bounded cancellation CancelInvocation

Open the exact OpenAPI document