Getting Started

Pre-Requisites and Usage

  • An active business on Cadana and an org API key is required to make payments.

Please go through the guides on API keys and authentication before you continue.

Step 1: Creating a beneficiary

To make a payment, you first need to create a beneficiary - the employee/contractor you want to pay. All beneficiaries are created against a support payout provider (i.e bank, wallet provider). You can use the following endpoint to get the list of supported banks and then proceed to create the beneficiary.

Get providers

Create a beneficiary

Step 2: Confirm Balance

Before you can initiate any payouts, your account must have sufficient balance to process the payment.

Balances

Step 3: Creating a payout

You now need to create an fxQuote that will be used to initiate a payment to the beneficiary. The FX quotes are short lived and typically expire within 5 mins. Once you have the fxQuote you can initiate the payout.

FX Quotes

Create a payout

Step 4: Monitor payout status

You can use the GET payouts endpoint to view the status of a transaction. Webhooks are also emitted when the state of a transaction is updated.

Get a payout