API Overview - Cadana Developers

The Cadana API is organized around REST. It accepts and returns JSON, uses standard HTTP response codes, and follows the OpenAPI 3.0 specification.

Base URLs

Environment	URL
Production	`https://api.cadanapay.com`
Sandbox	`https://dev-api.cadanapay.com`

All endpoints use the /v1/ prefix.

Money Amounts

Two representations are used, depending on the API family:

Representation	Example ($1,000.00)	Used by
Integer, minor units (cents)	`{ "amount": 100000, "currency": "USD" }`	Workforce API — persons, payrolls, invoices, business balances, wallet balances
Decimal string, major units	`{ "value": "1000.00", "currency": "USD" }`	Wallets API — transactions, fees, transfer limits

Wallet transactions use decimal strings because user wallets can hold assets — including crypto like BTC — whose precision doesn’t fit a fixed minor-unit integer. Check the schema of each endpoint before parsing: the same wallet reports its balance in minor units and its transactions in major units.

APIs

Workforce API

Manage employees, contractors, and payroll

Payments API

Send payments to anyone, anywhere

Wallets API

End-user wallet operations

Tax API

Gross-to-net tax calculations for 150+ countries

Next Steps

Authentication — Set up API keys and tokens
Sandbox & Testing — Test in the sandbox environment
Webhooks — Receive real-time event notifications
Pagination — Navigate paginated responses

Sandbox & Testing

⌘I

​Base URLs

​Money Amounts

​APIs