TransactKit-Pro quickstart

Prerequisites

• A TransactKit-Pro purchase and downloaded source archive
• Java 25 or newer
• A current browser

Run the local defaults

Extract the purchased archive, enter the TransactKit-Pro directory, and use the included Maven wrapper.

./mvnw spring-boot:run

.\mvnw.cmd spring-boot:run

✓ The application starts on http://localhost:8080 with in-memory H2, Flyway V1-V3, and no Stripe credentials.

Verify the local application

Open http://localhost:8080/api-test/index.html. The dependency-free console exposes 22 actions across configuration, Customers, one-time payments, refunds, catalogue, subscriptions, Portal, invoices, Entitlements, and usage.

• GET /api/configuration returns safe booleans and never returns secret values.
• GET /actuator/health and GET /actuator/info remain available.
• Stripe-dependent calls return a controlled 503 Problem Detail until STRIPE_SECRET_KEY is configured.

Connect Stripe Test Mode

Copy .env.example to the ignored .env file only when you are ready to exercise Stripe APIs. Add a restricted test-mode secret key, configure trusted redirect URLs, and restart the application.

STRIPE_SECRET_KEY=sk_test_replace_me
STRIPE_SUCCESS_URL=http://localhost:8080/api-test/success.html
STRIPE_CANCEL_URL=http://localhost:8080/api-test/cancel.html
STRIPE_PORTAL_RETURN_URL=http://localhost:8080/api-test/index.html