Getting Started

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

Sign in to the Cadana Dashboard (or request access)
Go to Settings → Developers
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

Environment	Base URL	Purpose
Sandbox	`https://dev-api.cadanapay.com`	Development and testing
Production	`https://api.cadanapay.com`	Live transactions

Sandbox and production use separate API keys and data. Start in sandbox.

3. Make Your First Request

Test your API key by asking the API who you are:

Bash

curl -X GET 'https://dev-api.cadanapay.com/v1/me' \
  -H 'Authorization: Bearer YOUR_API_KEY'

A successful 200 response confirms your key is working and returns your key’s access level and your business — including the businessId and tenant key that other endpoints ask for:

JSON

{
  "apiKey": {
    "id": "ba51f42c-0adc-4a77-8dd1-a03dd4fb955f",
    "accessLevel": "FULL",
    "status": "active",
    "description": "Sandbox key"
  },
  "business": {
    "id": "1f7b33d4-45c6-4a66-b58f-2f6b3d3e5a10",
    "tenantKey": "acme-us",
    "name": "Acme Inc.",
    "country": "US"
  }
}

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

Introduction

Authentication

⌘I

Get Started

Workforce Management

Payroll & Compliance

White-Label UI

Platform Integration

Payments

Wallets

1. Get Your API Key

2. Environments

3. Make Your First Request

Next Steps

Payments

Workforce

Authentication

Sandbox & Testing

​1. Get Your API Key

​2. Environments

​3. Make Your First Request

​Next Steps

Payments

Workforce

Authentication

Sandbox & Testing

1. Get Your API Key

2. Environments

3. Make Your First Request

Next Steps