AI-Powered Shoparcade

Monkey Bike Rental

Bike rental 24 Hr. 200bath/day

AI Orders

AI Agents

Menu Items

How AI Agents Order (AICP V1)

REST / JSON

Discover Store Capabilities (Layer 1)

GET https://pugmod.com/api/v1/commerce/store/34b14c74-833e-4b7a-98b6-82b2ae7a34c4/capabilities

Fetch the Active Contract (Layer 2)

GET https://pugmod.com/api/v1/commerce/store/34b14c74-833e-4b7a-98b6-82b2ae7a34c4/order-schema?intent=order

POST https://pugmod.com/api/v1/commerce/store/34b14c74-833e-4b7a-98b6-82b2ae7a34c4/agents/register

Browse Catalog & Keep Stable Item IDs

GET https://pugmod.com/api/v1/commerce/store/34b14c74-833e-4b7a-98b6-82b2ae7a34c4/menu

Validate Answers & Place an Idempotent Order

POST https://pugmod.com/api/v1/commerce/store/34b14c74-833e-4b7a-98b6-82b2ae7a34c4/orders

Create Payment Action (When Advertised)

POST https://pugmod.com/api/v1/commerce/store/34b14c74-833e-4b7a-98b6-82b2ae7a34c4/orders/<order_id>/payment

Track Live Order Status

GET https://pugmod.com/api/v1/commerce/store/34b14c74-833e-4b7a-98b6-82b2ae7a34c4/track/<order_id>

Example: Place Order

Read the active contract first and replace the example answers with every field it requires. Use catalog IDs instead of names, and reuse an idempotency key only when retrying the same order.

# 1. Discover the exact fields required for an order
curl "https://pugmod.com/api/v1/commerce/store/34b14c74-833e-4b7a-98b6-82b2ae7a34c4/order-schema?intent=order"

# 2. Submit answers that conform to that contract
curl -X POST https://pugmod.com/api/v1/commerce/store/34b14c74-833e-4b7a-98b6-82b2ae7a34c4/orders \
  -H "Authorization: Bearer pgm_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UUID_V4" \
  -d '{
    "intent": "order",
    "items": [
      {"id": "41afa84d-a04c-4a71-918d-76234d7310e5", "quantity": 1}
    ],
    "answers": {
      "REQUIRED_FIELD_FROM_SCHEMA": "VALUE"
    },
    "notes": "No sugar please"
  }'

View Store on Map Open API (JSON)