> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cadanapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Postman Collection

> Test Cadana APIs with Postman

Explore and test Cadana APIs using our official Postman workspace.

<Card title="Open in Postman" icon="rocket" href="https://www.postman.com/cadana/workspace/cadana-developers">
  Access all Cadana API collections with pre-configured requests
</Card>

***

## Available Collections

| Collection        | Description                                         |
| :---------------- | :-------------------------------------------------- |
| **Payments API**  | Payouts, beneficiaries, FX quotes, virtual accounts |
| **Wallets API**   | User wallets, transfers, user beneficiaries         |
| **Workforce API** | Payroll, persons, users, compliance                 |
| **Tax API**       | Tax calculations, statutory info                    |

***

## Quick Setup

### 1. Fork the Workspace

1. Open the [Cadana Developers workspace](https://www.postman.com/cadana/workspace/cadana-developers)
2. Click **Fork** on any collection you want to use
3. Select your destination workspace

### 2. Set Up Environment

Create an environment with these variables:

| Variable      | Value                                                                                 |
| :------------ | :------------------------------------------------------------------------------------ |
| `baseUrl`     | `https://dev-api.cadanapay.com` (sandbox) or `https://api.cadanapay.com` (production) |
| `bearerToken` | Your API key                                                                          |
| `tenantKey`   | Your business tenant key (for platform integrations)                                  |

### 3. Make Requests

1. Select your environment from the dropdown
2. Choose a request from the collection
3. Click **Send**

***

## Multi-Tenant Requests

For platform integrations, include the tenant header:

```
X-MultiTenantKey: {{tenantKey}}
```

This is pre-configured in the collections for endpoints that require it.

***

## Staying Updated

The Postman collections are synced with our OpenAPI specifications. Fork the collections to receive updates when the API changes.

***

## Troubleshooting

### "401 Unauthorized"

* Verify `bearerToken` is set correctly
* Check you're using the right environment (sandbox vs production)
* For platform tokens, ensure `tenantKey` is set

### "400 Bad Request"

* Check required fields in the request body
* Verify data types match the expected schema

***

## Need Help?

<CardGroup cols={2}>
  <Card title="API Reference" icon="code" href="/reference/api-overview">
    Full endpoint documentation
  </Card>

  <Card title="Get Support" icon="headset" href="https://cadanapay.com/book-demo">
    Talk to our team
  </Card>
</CardGroup>