{"uid":"cap_DuEKyDb7rz6Tjei4yi-Nt","slug":"basaltsurge-x402-order-placement-f3033e02","name":"BasaltSurge x402 Order Placement","description":"Basaltsurge is a full‑stack crypto commerce platform: multi‑currency payments (USDC, ETH, cbBTC) on Base, the x402 agentic payment standard, Google's Universal Commerce Protocol (UCP), instant receipts & QR terminals, on‑chain split releases, shops, loyalty, and whitelabel partner containers.","url":"https://surge-sand.basalthq.com/api/x402/orders?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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)"}}},"responseSchema":{"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"}}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PTaRDApjO4UWt0s_W323j","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a paid crypto commerce order for items in a BasaltSurge shop, processing payment and returning a receipt","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T04:06:56.924Z","isFirstParty":false,"canonicalSlug":"basaltsurge-x402-order-placement-f3033e02"}