Skip to main content
POST

Notes

  • Returns HTTP 402, not 200. Your integration passes this body to the bot.
  • The body is the x402 version 1 envelope (x402Version and accepts) followed by Xenarch fields. See How it works.
  • payTo and seller_wallet are the publisher’s wallet: the default receiving wallet chosen in the dashboard. The gate records it, so verification checks the same address. There is no Xenarch contract in the payment path.
  • maxAmountRequired is the price in USDC atomic units (6 decimals).
  • facilitators lists the x402 facilitators the agent may settle through. Agents may also use their own.
  • The price comes from the site’s pricing rules: the longest matching rule wins, otherwise the site default applies.
  • An unpaid gate expires after 30 minutes.
  • If the request carries an Origin or Referer header, it must match the site’s domain, or the request returns HTTP 403. Server-to-server calls without either header are accepted.
  • A site created without a domain claims it from the first gate request that carries Origin or Referer. Until then, a request without either header returns HTTP 409.
  • detection_method is an optional label recorded with the gate.

Headers

x-site-token
string | null

Body

application/json
url
string
required
detection_method
string | null

Response

Successful Response

accepts
PaymentRequirements · object[]
required
gate_id
string<uuid>
required
price_usd
string
required
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
seller_wallet
string
required
network
string
required
facilitators
FacilitatorOption · object[]
required
verify_url
string
required
expires
string<date-time>
required
x402Version
integer
default:1
error
string | null
xenarch
boolean
default:true
asset
string
default:USDC
protocol
string
default:x402