Payments & Subscriptions > Payment Engine Overview
Payments & Subscriptions > Payment Engine OverviewKroxt BaaS SDK v1.0.5

Payment Engine Overview

Kroxt BaaS provides a built-in payment engine designed to accept checkout payments, manage recurring subscription plans, track customer subscriptions, and process verified webhooks automatically inside your database.

Extensible Multi-Gateway Architecture

Paystack is supported out-of-the-box with dedicated Plan sync, HMAC SHA-512 signature validation, and subscription management. Support for Stripe and Flutterwave utilizes the exact same SDK API contracts (baas.payment.*).

SDK Module Access

Access the payment module using baas.payment on your Kroxt client instance:

payment-init.ts
1
2
3
4
5
6
7
8
9
10
11
12
import Kroxt from "@kroxt/baas-sdk";

const baas = new Kroxt({
  projectId: "YOUR_PROJECT_ID",
  apiKey: "YOUR_API_KEY",
});

// All payment methods are available on baas.payment
// baas.payment.initializeTransaction(...)
// baas.payment.verifyTransaction(...)
// baas.payment.createPlan(...)
// baas.payment.cancelSubscription(...)

Console Gateway Configuration

Navigate to Console > Payments > Gateway Settings to enable payments and configure your credentials:

  • Public Key: Paystack public key (pk_test_... or pk_live_...)
  • Secret Key: Paystack secret key (sk_test_... or sk_live_...) used to sign API requests
  • Webhook Secret: Secret used to verify Paystack HMAC signatures (defaults to Secret Key if omitted)
  • Kroxt Webhook Endpoint: Paste https://api.kroxt.com/payment/webhooks/YOUR_PROJECT_ID/paystack into Paystack Dashboard