Developer Tools
UNIVERSAL CHECKOUT
Integrate KAELUM Payments in Minutes, with No Platform Lock-In.
Get Started in 3 Simple Steps
Copy three lines of code, add your merchant key, and start accepting KAELUM payments instantly. No complex setup, no hidden fees.
Minutes
Setup time
Secure
By default
Universal
Any platform
Go to Kaelum Dashboard → E-Commerce Hub → Universal Checkout
You'll need:
- Merchant Key:
mk_live_xxxxx - Webhook Secret:
whsec_merchant_xxxxx - Allowed Origins: Add your website domain (e.g., https://yourstore.com)
Place this code on your product or checkout page:
① Config (your credentials):
<!-- Config (put this before the script) -->
<script>
window.kaelumMerchantKey = "mk_live_xxxxx"; // from Dashboard
window.kaelumDiscountPct = 0.18; // optional (minimum 6%, defaults to your Dashboard setting)
</script>② Load SDK:
<!-- Kaelum Universal SDK -->
<script src="https://kaelum.app/functions/universalIntegrationScript" defer></script>③ Render Button:
<!-- Where the button should appear -->
<div id="pay-with-kaelum"></div>
<script>
window.Kaelum.renderButton("#pay-with-kaelum", {
orderId: "ORD-12345",
amount: 7400, // minor units (pence) => £74.00
currency: "GBP",
customerEmail: "customer@example.com", // optional
successUrl: "https://yourstore.com/thank-you?order=ORD-12345",
cancelUrl: "https://yourstore.com/cart"
});
</script>What happens: The SDK creates a secure session and opens a hosted checkout. On success, KAELUM calls your webhook and redirects users to your success URL.
You'll receive signed events like checkout.session.completed
See the Webhooks tab for complete Node/Express and PHP examples with HMAC verification.
Popup blank / white screen
Ensure https://kaelum.app/checkout/:sessionId is reachable. Contact KAELUM support if issue persists.
CORS error
Add your domain to Allowed Origins in KAELUM Dashboard → E-Commerce Hub → Universal Checkout.
No webhook received
- Endpoint must be publicly reachable (HTTPS)
- Check server logs for incoming requests
- Verify raw body handling and HMAC header verification
- Ensure webhook URL is configured in Dashboard
"Payment unavailable"
Your merchant account may not be fully onboarded as a verified KAELUM merchant. Confirm your merchant status in the Dashboard. Customers pay from their KAE balance and can top up if short, and settlement is completed in KAE.
Need Help Getting Started?
Our dedicated support team is here to help you integrate quickly and efficiently. From technical questions to best practices, we've got you covered.
Technical Support
Get help with integration, webhooks, and API implementation
Documentation
Comprehensive guides, code examples, and best practices
Enterprise Support Available
Need dedicated integration assistance or custom features? Contact our enterprise team for white-glove support.