Skip to main content
Cadana provides APIs for global payroll, cross-border payments, and multi-currency wallets. This guide gets you set up and making your first API call.

​
1. Get Your API Key

  1. Sign in to the Cadana Dashboard (or request access)
  2. Go to Settings → Developers
  3. Create a new API key and copy it — it won’t be shown again
Cadana supports different token types depending on your integration. Most integrations start with an Org API key.
Keep your API key secret. Never expose it in client-side code or public repositories.

​
2. Environments

EnvironmentBase URLPurpose
Sandboxhttps://dev-api.cadanapay.comDevelopment and testing
Productionhttps://api.cadanapay.comLive transactions
Sandbox and production use separate API keys and data. Start in sandbox.

​
3. Make Your First Request

Test your API key with a simple request:
Bash
curl -X GET 'https://dev-api.cadanapay.com/v1/balances' \
  -H 'Authorization: Bearer YOUR_API_KEY'
A successful 200 response confirms your key is working:
JSON
{
  "data": [
    {
      "id": "517075a2-17db-469f-9481-eb8347cb920c",
      "currency": "USD",
      "balance": 0,
      "available": 0,
      "processing": 0
    }
  ]
}
If you get 401 Unauthorized, check that you’re using a sandbox API key with the sandbox URL.

​
Next Steps

Payments

Send payouts to bank accounts and mobile wallets globally

Workforce

Pay employees and contractors via payroll

Authentication

Token types, multi-tenant setup, and security

Sandbox & Testing

Test your integration with simulated data