> ## Documentation Index
> Fetch the complete documentation index at: https://arcpay-somnia.vercel.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Verify an on-chain order

> Checks AgentOrderBook state and returns whether the order is paid, fulfilled, unlocked, or settled.



## OpenAPI

````yaml /apps/frontend/public/openapi.json post /x402/verify
openapi: 3.1.0
info:
  title: ArcPay Somnia Developer API
  version: 0.1.2
  summary: >-
    Public developer surface for ArcPay's Somnia x402, workspace evidence, and
    agent integration flows.
  description: >-
    ArcPay Somnia exposes a wallet-first app, a live x402 payment server, an MCP
    server for local agent hosts, and OpenAPI-compatible endpoint docs for
    developers building on Somnia Testnet.
servers:
  - url: https://x402.20.208.46.195.nip.io
    description: Live ArcPay Somnia x402 server
  - url: https://arcpay-somnia.vercel.app
    description: ArcPay Somnia frontend and workspace API
security: []
tags:
  - name: x402
    description: HTTP 402 payment-gated agent work on Somnia.
  - name: Workspace
    description: Workspace authentication and evidence mirror endpoints.
  - name: Beta
    description: Public beta access requests for Somnia builders and operators.
  - name: Discovery
    description: Machine-readable docs and integration discovery.
  - name: Developer Tools
    description: HTTP wrapper around safe ArcPay MCP-style tools.
  - name: MCP
    description: Hosted MCP-style JSON-RPC bridge for agent clients.
  - name: Developer Keys
    description: Workspace-scoped bearer keys for hosted MCP access.
  - name: Admin
    description: Operator-only beta queue management endpoints.
  - name: Status
    description: Runtime health checks for ArcPay Somnia production surfaces.
paths:
  /x402/verify:
    post:
      tags:
        - x402
      summary: Verify an on-chain order
      description: >-
        Checks AgentOrderBook state and returns whether the order is paid,
        fulfilled, unlocked, or settled.
      operationId: verifyX402Order
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VerifyOrderRequest'
            example:
              orderId: 0xabc123...
              agentSlug: research-agent
      responses:
        '200':
          description: Verification result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerificationResult'
components:
  schemas:
    VerifyOrderRequest:
      type: object
      required:
        - orderId
      properties:
        orderId:
          type: string
        agentSlug:
          type: string
        requester:
          type: string
    VerificationResult:
      type: object
      properties:
        ok:
          type: boolean
        paid:
          type: boolean
        unlocked:
          type: boolean
        settled:
          type: boolean
        statusName:
          type: string
        amountStt:
          type: string
        requester:
          type: string
        provider:
          type: string
        resultUri:
          type: string

````