TKH PaymentsDeveloper documentation

HTTP API for payment intents, gateway webhooks, and SNS events — one place for Events, Kaba, School, and future TKH apps.

Integration guide

Open API service README

REST API

Authenticate with X-API-Key, create intents, poll status or verify KkiaPay widget payments.

SNS events

Subscribe your Lambdas with appId filters for payment.completed and related events.

Same source as the repo

The long-form guide is built from INTEGRATION.md in the payments repository — no second manual copy to maintain.

Who this is for

Backend engineers integrating a TKH product with the shared payments Lambda. Start with Integration guide for authentication, payloads, CDK wiring, and FAQs.

Local preview

Run from payments/docs-site:

bash

npm install && npm run dev

Then open the URL shown in the terminal (usually http://localhost:5173).

Publishing

Deploy the static output of npm run build (directory .vitepress/dist) to Vercel, Netlify, S3 + CloudFront, or GitHub Pages. See DEPLOY.md in this folder for Vercel settings.