> ## 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.

# Provider fulfill an order

> Fulfills a paid order from the x402 server's configured provider wallet. Requires admin authorization in production.



## OpenAPI

````yaml /apps/frontend/public/openapi.json post /agent/{agentSlug}/provider/fulfill
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:
  /agent/{agentSlug}/provider/fulfill:
    post:
      tags:
        - x402
      summary: Provider fulfill an order
      description: >-
        Fulfills a paid order from the x402 server's configured provider wallet.
        Requires admin authorization in production.
      operationId: fulfillX402Order
      parameters:
        - name: agentSlug
          in: path
          required: true
          schema:
            type: string
            example: research-agent
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FulfillOrderRequest'
            example:
              orderId: 0xabc123...
              resultUri: ipfs://arcpay-x402-result/research-agent
      responses:
        '200':
          description: Order fulfilled.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FulfillOrderResponse'
      security:
        - adminBearer: []
components:
  schemas:
    FulfillOrderRequest:
      type: object
      required:
        - orderId
        - resultUri
      properties:
        orderId:
          type: string
        resultUri:
          type: string
    FulfillOrderResponse:
      type: object
      properties:
        ok:
          type: boolean
        statusName:
          type: string
        txs:
          type: array
          items:
            type: string
  securitySchemes:
    adminBearer:
      type: http
      scheme: bearer

````