Search Kivvo docs/

Kivvo developer docs

Build saving and payment experiences with Kivvo.

Explore our guides, APIs, webhooks and examples for connecting Kivvo Savings, Kivvo Pay, Circles and the Kivvo Balance to your product.

Kivvo Developer API is in the works.

We’re building the API carefully, with security and reliability first. These docs are the foundation for the upcoming developer platform.

Explore the docs Explore products

API request example

curl https://api.kivvo.co.nz/v1/balance \
  -H "Authorization: Bearer $KIVVO_SECRET_KEY" \
  -H "Idempotency-Key: request_123"

Keep secret keys server-side. Never place them in browser code.

APIs & SDKs

Documentation

Explore secure guides and examples for integrating Kivvo.

Need help?

Developer resources

Everything you need to move from your first request to production.

API reference

Requests, responses, errors and pagination.

Security guide

Keys, sessions, webhooks and safe deployments.

CLI and examples

Run safe test-mode requests from your terminal.

Product help

User-facing setup and troubleshooting guides.

Try it out

Use test mode with environment variables. Never paste live credentials into documentation or client-side code.

Start a payment Create a checkout session Create a customer Create a savings goal Send a test transfer Get your balance

# Configure locally
$env:KIVVO_SECRET_KEY = "sk_test_..."

# Create a test payment
curl https://api.kivvo.co.nz/v1/payments \
  -H "Authorization: Bearer $KIVVO_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount_cents": 1000, "currency": "nzd"}'

Test-mode credentials and sample IDs are placeholders. Rotate any key that has been exposed.

Kivvo