{"openapi":"3.1.0","info":{"title":"x402card API","version":"0.1.0","description":"API-first wallet-native x402 card service. Agents should use this API or the MCP endpoint, not the human root page."},"servers":[{"url":"https://api.x402card.org"}],"paths":{"/health":{"get":{"summary":"Liveness check","responses":{"200":{"description":"Database-backed liveness"}}}},"/ready":{"get":{"summary":"Deep production readiness","responses":{"200":{"description":"Ready"},"503":{"description":"Not ready"}}}},"/mcp":{"get":{"summary":"MCP endpoint descriptor","responses":{"200":{"description":"MCP descriptor"}}},"post":{"summary":"MCP Streamable HTTP JSON-RPC endpoint","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"JSON-RPC response"},"202":{"description":"Notification accepted"}}}},"/api/agent":{"get":{"summary":"Machine-readable agent contract","responses":{"200":{"description":"Agent contract"}}}},"/api/openapi.json":{"get":{"summary":"OpenAPI document","responses":{"200":{"description":"OpenAPI 3.1 document"}}}},"/api/config":{"get":{"summary":"Public runtime config","responses":{"200":{"description":"Network, card, fee, and limit config"}}}},"/api/auth/challenge":{"post":{"summary":"Create wallet sign-in challenge","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["address"],"properties":{"address":{"type":"string"}}}}}},"responses":{"200":{"description":"Challenge message"}}}},"/api/auth/verify":{"post":{"summary":"Verify wallet signature and mint x402card session","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["address","message","signature"],"properties":{"address":{"type":"string"},"message":{"type":"string"},"signature":{"type":"string"}}}}}},"responses":{"200":{"description":"Bearer token"},"401":{"description":"Invalid signature"}}}},"/api/cards":{"get":{"summary":"List owner cards","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Cards"},"401":{"description":"Missing or invalid session"}}},"post":{"summary":"Create or return owner card","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Card"},"401":{"description":"Missing or invalid session"}}}},"/api/orders":{"get":{"summary":"List owner orders","security":[{"bearerAuth":[]}],"parameters":[{"name":"status","in":"query","schema":{"type":"string","enum":["active"]}}],"responses":{"200":{"description":"Orders"},"401":{"description":"Missing or invalid session"}}},"post":{"summary":"Create payable x402 order","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"oneOf":[{"type":"number"},{"type":"string"}]},"amountUsdCents":{"type":"integer"},"resource":{"type":"string","format":"uri"}}}}}},"responses":{"200":{"description":"Order with payable_url"},"401":{"description":"Missing or invalid session"}}}},"/api/orders/{orderId}":{"get":{"summary":"Get owner order","security":[{"bearerAuth":[]}],"parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Order"},"404":{"description":"Order not found"}}}},"/api/orders/{orderId}/pay":{"post":{"summary":"Submit x402 payment signature directly","security":[{"bearerAuth":[]}],"parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["paymentSignature"],"properties":{"paymentSignature":{"type":"string"}}}}}},"responses":{"200":{"description":"Settlement/funding result"},"402":{"description":"Payment rejected"}}}},"/pay/{orderId}":{"get":{"summary":"Public x402 payable endpoint","parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Paid/funding result"},"402":{"description":"PAYMENT-REQUIRED header with x402 requirements"}}},"post":{"summary":"Public x402 payable endpoint","parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Paid/funding result"},"402":{"description":"PAYMENT-REQUIRED header with x402 requirements"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}