Skip to main content
POST

Body

What Xenarch checks

  1. The transaction hash has not been recorded for a different gate.
  2. The gate has not expired.
  3. The transaction receipt on Base exists and the transaction succeeded.
  4. The receipt contains a USDC Transfer to the seller wallet recorded on the gate.
  5. The transferred amount is at least the gate price.
On success Xenarch records the payment, marks the gate paid, and returns the record. There is no access token. The agent proves access on each request with the X-Xenarch-Gate-Id and X-Xenarch-Tx-Hash headers, and your integration calls this endpoint to check them.

Notes

  • Idempotent. Sending the same gate_id and tx_hash again returns the same record.
  • One gate per transaction. A tx_hash already recorded for another gate returns HTTP 409.
  • Several payers per gate. Different agents can pay the same gate with different transactions. Each gets its own record.
  • An expired gate returns HTTP 410. A failed transaction, a missing transfer or a short amount returns HTTP 400. HTTP 502 means Base RPC could not be reached: retry.
  • No authentication is required.

Plain x402 payments

An agent that sends a standard x402 X-PAYMENT header instead of a transaction hash is handled by POST /v1/gates/{gate_id}/settle-x402 with the body {"x_payment": "<raw header value>"}. Xenarch passes the signed authorization to a facilitator from the default stack, then runs the same checks and returns the same record. The WordPress and Joomla plugins and the Cloudflare Worker call it for you.

Path Parameters

gate_id
string<uuid>
required

Body

application/json
tx_hash
string
required
Pattern: ^0x[0-9a-fA-F]{64}$
facilitator
string | null

Name of the facilitator that settled the payment, for example PayAI. Optional. Used for metrics only.

Maximum string length: 128

Response

Successful Response

gate_id
string<uuid>
required
status
string
required
tx_hash
string
required
amount_usd
string
required
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
verified_at
string<date-time>
required