API

Base: http://127.0.0.1:43127. Machine index: GET /api. Full markdown: docs/API.md

Admin: add receive wallets (one default per asset you accept)
POST /api/shop/checkout with cart fiat — with asset (shop chose) or without (buyer chooses on Cryout)
Redirect buyer to checkoutUrl
Poll GET /api/shop/checkout/:id until status: completed — save confirmationId

Method	Path	What
GET	/api	Catalog + enums
POST	/api/shop/checkout	Shop pay session → checkoutUrl (no walletId)
GET	/api/shop/checkout	List shop sessions + accept assets
GET	/api/shop/checkout/:id	Shop session + QR / mint
POST	/api/shop/checkout/:id/asset	Buyer picks crypto (Mode B)
POST	/api/shop/checkout/:id/verify	Verify shop payment on-chain
POST	/api/admin/login	Admin login
GET	/api/admin/session	Admin session
GET	/api/providers	List providers
GET	/api/tokens	Token mints (Solana USDT/USDC…)
POST	/api/quote	Quote (auto / manual / all)
GET	/api/wallets	List receive wallets
POST	/api/wallets	Create receive wallet
GET	/api/wallets/:id	Get wallet
PATCH	/api/wallets/:id	Update wallet
DELETE	/api/wallets/:id	Delete wallet
GET	/api/settings	Get email settings
PUT	/api/settings	Set email (required ops contact)
GET	/api/orders	List orders
POST	/api/orders	Card on-ramp order (ops)
GET	/api/orders/:id	Get order + outcome
POST	/api/orders/:id/verify	Verify card on ephemeral address
POST	/api/webhooks/onramp	Indexer: ephemeral credit
GET	/api/ephemeral/:id/sweep	Sweep fee + margin quote
POST	/api/ephemeral/:id/sweep	Sweep to main wallet
PATCH	/api/orders/:id	Admin force status
GET	/api/confirmations/:id	Esito by confirmationId
POST	/api/deposits	Low-level crypto pay (needs walletId)
GET	/api/deposits/:id	Deposit + QR
POST	/api/deposits/:id/verify	Verify on-chain deposit
POST	/api/webhooks/deposit	Chain watcher webhook
PATCH	/api/deposits/:id	Admin force status
GET	/api/swaps/providers	Swap providers (off by default)
POST	/api/swaps/quote	Swap quote
GET	/api/swaps	List swaps
POST	/api/swaps	Create swap → depositUrl
GET	/api/swaps/:id	Get swap + outcome
PATCH	/api/swaps/:id	Update swap status

curl -X POST http://127.0.0.1:43127/api/shop/checkout \
  -H 'Content-Type: application/json' \
  -d '{
    "fiatAmount": 49.99,
    "fiat": "EUR",
    "asset": "USDT",
    "email": "buyer@shop.com",
    "externalOrderId": "ORD-1001",
    "returnUrl": "https://yoursite.com/thanks"
  }'