Platform

Developer

API keys

  • Production

    read + write

    sk_live_••••••••••••42a1

  • Sandbox

    read + write

    sk_test_••••••••••••9902

  • Analytics (RO)

    read

    sk_live_••••••••••••11cc

Create a payment · quickstart

curl -X POST https://api.falcon.kw/v1/payments \
  -H "Authorization: Bearer sk_live_••••42a1" \
  -H "Idempotency-Key: pmt_9f3e21" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "acc_001",
    "to_iban": "KW44 NBOK 0000 9911 2233 4455",
    "amount": 24500.000,
    "currency": "KWD",
    "rail": "knet",
    "reference": "INV-2026-4489"
  }'

Webhooks

  • https://api.acme.kw/webhooks/falcon

    payment.settled, payment.failed

    Active
  • https://logs.acme.kw/audit-sink

    audit.*

    Active
  • https://sandbox.acme.kw/hooks

    *

    Paused

Rate limits

  • Read2,000 / min
  • Write400 / min
  • Bulk payments50 / min

SDKs

TypeScriptPythonGoJavaPHPRuby

Environments

  • Productionapi.falcon.kw
  • Sandboxsandbox.falcon.kw