Skip to main content
Cadana’s Payments API lets you pay employees and contractors through local payment rails and SWIFT across a broad network of countries.

Features

FX Rate Retrieval

Access real-time foreign exchange rates and lock quotes before sending payments.

Beneficiary Management

Create and manage reusable payment destinations to streamline repeat payouts.

Payment Processing

Initiate payouts to bank accounts and mobile wallets with built-in compliance checks.

Payment Tracking

Monitor the status of every payment in real-time via API polling or webhooks.

Global Coverage

Send payments in multiple currencies through local rails and SWIFT across a broad network of countries.

How It Works

Every payout follows four steps:
1

Discover requirements

Call GET /v1/payment-requirements to get the required fields for a country and payment method. Call GET /v1/providers to list supported banks and mobile money providers.
2

Create a beneficiary

Store the recipient’s payment details with POST /v1/beneficiaries. Beneficiaries are reusable — create once, pay many times.
KYC documents (e.g., a government-issued ID) are required for beneficiaries. Upload documents via POST /v1/files/upload-url before creating the beneficiary. See Making a Payment for the full flow.
3

Send a payout

Check your balance, lock an FX rate with POST /v1/fx/quotes, then execute the payout with POST /v1/payouts using the returned quote id.
4

Track the payment

Poll GET /v1/payouts/:id or subscribe to webhooks for real-time status updates.

API Endpoints

Beneficiaries

Payouts

FX

Balances

Discovery


Webhook Events

Subscribe to these events to track payment lifecycle changes: See Webhooks to configure your endpoint.

Next Steps

Making a Payment

Step-by-step integration guide

Payment Methods & Requirements

Supported methods and required fields per corridor

RFI & Compliance

Handling compliance holds and document requests