API Contracts

API Conventions
Base URL and Versioning
Authentication
Standard Error Response
Standard HTTP Status Codes
identity-svc API
POST /auth/login
POST /auth/register
POST /auth/refresh
merchant-svc API
POST /merchants
GET /merchants/{merchantId}
catalog-svc API
POST /products
GET /products?search={query}
order-svc API
POST /orders
GET /orders/{orderId}
payment-svc API
POST /intents
POST /intents/{intentId}/capture
POST /refunds
ledger-svc API
GET /balance
GET /ledger/entries
shipping-svc API
POST /shipments
GET /shipments/{shipmentId}/tracking
notif-svc API
POST /notifications
admin-svc API
GET /admin/dashboard
API Endpoint Summary