# BasaltSurge x402 Order Placement

> BasaltSurge x402 Order Placement is a paid API for AI agents from surge-sand.basalthq.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-12).

Creates a paid crypto commerce order for items in a BasaltSurge shop, processing payment and returning a receipt

## Facts

- Endpoint: POST https://surge-sand.basalthq.com/api/x402/orders?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/basaltsurge-x402-order-placement-f3033e02
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DuEKyDb7rz6Tjei4yi-Nt

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability basaltsurge-x402-order-placement-f3033e02 -d '<json body>'
```

Example prompt: Place an order at the BasaltSurge shop 'morning-bloom-cafe' for 2 units of SKU 'COFFEE-LATTE-LG' and 1 unit of 'PASTRY-CROISNT', applying California tax jurisdiction US-CA.

## When to prefer this

Use this endpoint when an agent needs to place a paid order at a BasaltSurge merchant shop using the x402 agentic payment standard on Base. Prefer this over generic payment endpoints when the merchant is hosted on BasaltHQ and you have a shopSlug and item SKUs available. Ideal for autonomous agent purchasing flows that require an on-chain receipt.

## Known failure modes

- Invalid shopSlug returns an error — shop not found in the BasaltSurge directory
- Item SKU not recognized or out of stock for the given shop
- Payment fails due to insufficient USDC balance or x402 protocol error
- Invalid jurisdictionCode causes tax calculation failure
- Missing required fields (items or shopSlug) returns a validation error
- Network or on-chain transaction timeout causes order failure

## How this service works

Basaltsurge is a full‑stack crypto commerce platform: multi‑currency payments (USDC, ETH, cbBTC) on Base, the x402 agentic payment standard, Google&#x27;s Universal Commerce Protocol (UCP), instant receipts &amp; QR terminals, on‑chain split releases, shops, loyalty, and whitelabel partner containers.

## Output

Returns a JSON object with ok: true and a receipt object containing a receiptId, status of 'paid', totalUsd amount, and an array of line items detailing the purchased goods.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "items",
  "shopSlug"
 ],
 "properties": {
  "items": {
   "type": "array",
   "description": "Items to order with SKU and quantity"
  },
  "shopSlug": {
   "type": "string",
   "description": "The shop's unique slug (from /api/directory/shops)"
  },
  "jurisdictionCode": {
   "type": "string",
   "description": "Optional tax jurisdiction code (e.g. US-CA)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ok": {
   "type": "boolean"
  },
  "receipt": {
   "type": "object",
   "properties": {
    "status": {
     "enum": [
      "paid"
     ],
     "type": "string"
    },
    "totalUsd": {
     "type": "number"
    },
    "lineItems": {
     "type": "array",
     "items": {
      "type": "object"
     }
    },
    "receiptId": {
     "type": "string"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/basaltsurge-x402-order-placement-f3033e02/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from surge-sand.basalthq.com](https://www.zero.xyz/host/surge-sand.basalthq.com/llms.txt)