Skip to main content

NestJS demo

The NestJS demo turns Openfield’s Riverbend Learning Garden campaign into a trusted contribution flow. Supporters choose a tier, and the server resolves its catalog price before creating an order and redirecting to Inttegro Checkout.

About the app

Openfield is an immediate-funding campaign rather than an all-or-nothing pledge. The visible GHS 50, 100, and 250 tiers are server-owned quantities of one published Product and Price, so a browser cannot submit its own amount.

What it demonstrates

  • NestJS controllers, dependency injection, and DTO validation
  • Typed Product lookup and Order creation with the Inttegro TypeScript SDK
  • A stable idempotency key and readable OPENFIELD-… order number
  • Safe errors and a 303 redirect to the hosted checkout URL returned by Inttegro

Run the demo

Provide a server-side API key, the campaign Product and Price IDs, and the application’s public origin. The released README contains the exact local, Docker, build, and test commands.

Follow the integration

  1. src/checkout.service.ts validates the selected tier, resolves the trusted catalog pair, and creates the order.
  2. src/campaign.controller.ts owns request validation, correlation, browser-safe failures, and the checkout handoff.

Production boundary

Persist the contribution attempt, idempotency key, and Inttegro order ID in your own database. Update campaign totals and issue receipts only after server-side verification of payment state; the browser return is navigation, not fulfillment evidence.

Continue