Developers · SDKs

Three languages, one shape.

The SDKs share one mental model: init with a key, act as a customer, read or propose. Pick your stack and make the first call.

Code samples Changelog

TypeScript

Web and Node, used by the Qoyla web cockpit itself.

npm

npm install @qoyla/sdk

first call · TS

import { Qoyla } from "@qoyla/sdk";

const qoyla = new Qoyla({ key: process.env.QOYLA_SANDBOX_KEY });
const sts = await qoyla.customer("cus_test_tunde").safeToSpend();

console.log(sts.amount, sts.record); // "542430.46", "QRY-STS-8821"

Kotlin

Android, ships with the React Native bridge for Expo apps.

build.gradle.kts

implementation("ai.qoyla:sdk:2.4.0")

first call · Kotlin

val qoyla = Qoyla(key = BuildConfig.QOYLA_SANDBOX_KEY)
val sts = qoyla.customer("cus_test_tunde").safeToSpend()

Log.d("qoyla", "${sts.amount} · ${sts.record}")

Swift

iOS 15+ via Swift Package Manager.

Package.swift

.package(url: "https://github.com/qoyla/qoyla-swift", from: "2.4.0")

first call · Swift

let qoyla = Qoyla(key: Secrets.qoylaSandboxKey)
let sts = try await qoyla.customer("cus_test_tunde").safeToSpend()

print(sts.amount, sts.record)

Patterns you’ll use everywhere

Act-as customer contextEvery call is scoped to one customer and their granted scopes, the SDK makes it impossible to forget.Webhook helpersBuilt-in signature verification and replay-safe handlers.

Idempotency by defaultProposals carry an idempotency key automatically, a retried request never double-proposes.

Something missing in your language?

Tell us what you’re building, the SDK roadmap is driven by partners.

Talk to an engineer SDK changelog