← Back

Build on the ledger

QuikyPay is a REST API + SDK. Every Magnus and Quiky product uses the same surface you do.

Quick start

# Authorize via MagnusID — QuikyPay trusts its tokens
const token = await magnusid.exchangeCode({ code, redirect_uri });

# Call wallet
const r = await fetch("https://pay.magnuscloud.ai/wallet", {
  headers: { authorization: `Bearer ${token.access_token}` },
});
const { wallet } = await r.json();
// → { balanceMinor: "0", currency: "USD", version: 0, updatedAt: "..." }

# Health check + status (agent-accessible, read-only)
curl https://pay.magnuscloud.ai/status

Current endpoints

  • GET /health
  • GET /ready
  • GET /version
  • GET /status
  • GET /api/ecosystem
  • GET /wallet (auth)
  • GET /wallet/transactions (auth)

Coming in the next build

  • POST /payments/intents
  • POST /payments/refunds
  • POST /wallet/transfer
  • POST /wallet/withdraw
  • POST /merchants
  • POST /payouts
  • POST /webhooks/stripe
  • POST /subscriptions

Sensitivity policy

QuikyPay is classified sensitive. AI agents can read status + balance + transaction history when a user grants quikypay:agent:read scope. Agents cannot move money, create payouts, change payment methods, or accept subscriptions on a user's behalf. Every write flows through a human confirmation step delivered via QuikyChat.