Developers · Quickstarts

Three builds, copy-paste ready.

Each sample runs against the sandbox as-is. Swap the key, keep the shape.

1 · Show safe-to-spend in your app

TypeScript

const sts = await qoyla.customer(customerId).safeToSpend();

render(`
  
${formatMoney(sts.amount, sts.currency)}
  
available to spend · why this number
`);
// Always link the number to its record, that’s the trust contract.

2 · Propose and approve a transfer

Kotlin

val proposal = qoyla.customer(id).propose(
  Transfer(to = "Emergency Fund", amount = "40000", currency = "NGN",
           reason = "Reaches the 90% milestone")
)
// show proposal.reason + proposal.tradeoffs in YOUR approval UI …
val approval = qoyla.customer(id).approve(proposal.id, biometricToken)

println(approval.record) // QRY-EVT-2K4A9, sealed, reversible window stated

3 · Verify a sealed record

curl

curl https://sandbox.api.qoyla.ai/v1/records/QRY-EVT-2K4A9 \
  -H "Authorization: Bearer $QOYLA_SANDBOX_KEY"

# → { "chain": ["reason","verification","action","outcome"],
#     "signatures": "valid", "reversible_until": "..." }