Skip to main content
POST
/
v1
/
statutory
/
remittances
Create a remittance
curl --request POST \
  --url https://api.cadanapay.com/v1/statutory/remittances \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "businessId": "<string>",
  "countryCode": "MX",
  "filingIds": [
    "<string>"
  ],
  "fundFromCurrency": "USD",
  "paymentReference": "0123456ABCD7890EF"
}
'
{
  "id": "fil_01HQ3K4N7XYZABC"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-MultiTenantKey
string

Required when using a Platform API token. The tenant key identifying which business to operate on.

Body

application/json
​
businessId
string
required
​
countryCode
string
required

ISO 3166-1 alpha-2 country code

Example:

"MX"

​
filingIds
string[]
required

Filings to remit for. Multiple filings to the same authority can be batched into a single remittance.

​
fundFromCurrency
string
required

Currency to debit from the business balance (auto-converted if needed)

Example:

"USD"

​
paymentDetails
object

Where Cadana sends the payment. Optional. Omit to use Cadana's internal default routing for the authority (recommended when you trust Cadana to know the right government account). Provide to specify the routing yourself — for example, a Mexican CLABE under bank.accountNumber. This is the same paymentMethods object used elsewhere in the API for beneficiaries and vendor payments.

​
paymentReference
string

Reference the receiving bank or authority uses to attribute the payment to your filing. If omitted, Cadana uses the linked filing's filingReference (e.g., the Línea de Captura in Mexico). Provide explicitly when the bank reference differs from the filing reference.

Example:

"0123456ABCD7890EF"

Response

Remittance created

Response containing the ID of a newly created resource.

​
id
string
Example:

"fil_01HQ3K4N7XYZABC"