How It Works
Filing is accepted
A filing must be in
accepted status before remittance. This can come from Cadana’s filing flow or from your own external filing process.Create remittance
Initiate a payment to the government authority. Specify which filings to pay and the currency to fund from.
Cadana converts and pays
Cadana handles FX conversion (if needed) and routes the payment to the correct government account through local payment rails.
Step 1: Create a Remittance
Once a filing is accepted, pay the authority. Specify the filing IDs, the country, and the currency you want to fund from: Response:Fetch the remittance to see amounts, FX rate, and status:
Step 2: Track Payment Status
Poll the remittance or listen for theremittance.completed webhook event:
Response:
Remittance Statuses
| Status | Description |
|---|---|
pending | Payment initiated, awaiting processing |
completed | Payment delivered to the government authority |
failed | Payment failed — check the error details and retry |
The status progresses:
pending → processing → completed.Step 3: Download Receipt
Once the remittance is completed, download the receipt for your audit trail: The receipt is returned as a PDF containing the authority’s confirmation of payment, the amount, and the filing reference number.Remittance Without Cadana Filing
If you handle filings yourself and only need Cadana to pay the authorities, you can still use the remittance API. Provide the filing amounts directly when creating the remittance.This is the remittance-only model. You prepare and submit filings through your own process, then use Cadana’s local payment rails to pay the government. See the modularity options for more detail.