API Documentation

Internal and external APIs active in the Skam ecosystem.

1. External APIs (Shopier)

Implemented in packages/shared/src/services/shopier.ts

Processing and fetching recent transactions

Checking the current store balance

Endpoints listening to payment success/failure callbacks

Required: Set SHOPIER_PAT (Personal Access Token) in your .env.local.

Next.js Route Handlers built on the App Router route.ts architecture.

/api/shopier/balanceGETFetches current store balance via RSCs

/api/shopier/transactionsGETFetches recent storefront transactions

/api/admin/metricsGETAggregates Shopier data for admin analytics

/api/webhooks/shopierPOSTSecure listener for live Shopier webhook updates

All data mutations use Next.js Server Actions instead of REST API endpoints.

apps/web/actions/Product management, push notifications, order tracking

apps/dashboard/actions/Admin tenant CRUD, bot settings, email triggers

Every action strictly validates input using Zod before executing Supabase Postgres mutations.