Skip to main content

Next.js demo

The Next.js demo implements Kora Market with the App Router. It combines a server-owned hosted checkout with the narrow order-creation endpoint used by all four mobile demos.

About the app

Kora Market is a direct retail storefront where shoppers can configure a Dawn Brew Set, review their bag, and move confidently into payment. The experience keeps the product story and purchase decision together instead of treating checkout as an unrelated technical step.

For the merchant, one application supports the web storefront and the ordering boundary used by the mobile demos. That creates a consistent commerce model across channels while keeping prices, orders, and credentials under server control.

Start with MCP

Connect your MCP client and ask MCP to adapt this storefront or mobile-backend flow to your Next.js application. It can separate browser, server, and native responsibilities before you write code.

What it demonstrates

  • A Next.js App Router storefront with a server-only checkout route
  • Typed order creation with the Inttegro TypeScript SDK
  • A narrow POST /mobile/orders backend that returns only a finalized order ID
  • Explicit completion and cancellation URLs for hosted checkout

Run the demo

Install a supported Node.js release, provide the server environment values, and start Next.js. Do not put the API key in a NEXT_PUBLIC_ value. The released README contains the exact commands and checks.

Follow the integration

  1. lib/checkout.ts builds hosted and native checkout orders.
  2. app/checkout/route.ts performs the browser checkout handoff.
  3. app/mobile/orders/route.ts enforces the mobile-to-merchant-backend trust boundary.

Production boundary

Authenticate and authorize the mobile route in a real application. Prices, currency, customer identity, and fulfillment decisions must remain under server control; the mobile client should receive only the checkout capability it needs.

Continue