KittoPay — Node.js SDK

Монголын анхны Developer-First QR Payment API.

Суулгах

npm install kittopay

Хэрэглэх

import KittoPay from 'kittopay'

const kitty = KittoPay({ apiKey: process.env.KITTOPAY_KEY })

// Invoice үүсгэх
const invoice = await kitty.invoice.create({
  amount: 50000,
  currency: 'MNT',
  description: 'Захиалга #1042',
  callbackUrl: 'https://yoursite.mn/webhook/kittopay',
  metadata: { order_id: 'ORD-1042' }
})

console.log(invoice.qr_url)   // QR зурагний URL
console.log(invoice.deeplink) // Банкны апп руу шууд нээх
console.log(invoice.id)       // inv_xxxxxxxxxxxx

Invoice API

// Invoice авах
const inv = await kitty.invoice.get('inv_xxx')

// Статус шалгах (polling-д тохиромжтой)
const { status, paid_at } = await kitty.invoice.getStatus('inv_xxx')

// Invoice цуцлах
await kitty.invoice.cancel('inv_xxx')

// Буцаан олгох
await kitty.invoice.refund('inv_xxx', { amount: 25000, reason: 'Хэрэглэгч буцаасан' })

// Жагсаалт
const { data, total } = await kitty.invoice.list({ status: 'paid', limit: 10 })

Webhook Signature Verification

import { verifyKittySignature } from 'kittopay/webhook'

app.post('/webhook/kittopay', (req, res) => {
  const sig = req.headers['x-kitty-signature']
  if (!verifyKittySignature(JSON.stringify(req.body), sig, process.env.KITTY_WEBHOOK_SECRET)) {
    return res.status(401).end()
  }

  const { event, data } = req.body
  if (event === 'invoice.paid') fulfillOrder(data.metadata.order_id)
  res.sendStatus(200)
})

API Key

Dashboard → API Keys хэсгээс key авна: kittopay.com/dashboard

| Төрөл | Prefix | Орчин | |--------|--------|-------| | Production | kp_live_ | Бодит гүйлгээ | | Sandbox | kp_test_ | Туршилт |

Docs

Бүрэн documentation: kittopay.com/docs

License

MIT © KittoPay