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>",
  "filingIds": [
    "<string>"
  ],
  "fundFromCurrency": "USD",
  "metadata": {}
}
'
{
  "id": "rem_01HQ3K4N7XYZABC",
  "businessId": "<string>",
  "filingIds": [
    "<string>"
  ],
  "countryCode": "MX",
  "authority": {
    "id": "auth_mx_sat",
    "name": "Servicio de Administración Tributaria",
    "abbreviation": "SAT",
    "countryCode": "MX",
    "electronicSystem": "Portal del SAT"
  },
  "status": "pending",
  "amounts": {
    "currency": "MXN",
    "amount": 45000,
    "fxRate": 123,
    "fundedCurrency": "USD",
    "fundedAmount": 2571.43
  },
  "paymentMethod": "Direct bank transfer to SAT via línea de captura",
  "paymentReference": "SAT-2026-01-RFC-XAXX010101000-ISR",
  "receiptUrl": "<string>",
  "submittedAt": "2023-11-07T05:31:56Z",
  "completedAt": "2023-11-07T05:31:56Z",
  "statusHistory": [
    {
      "status": "<string>",
      "changedAt": "2023-11-07T05:31:56Z",
      "actor": "<string>",
      "blockedReasons": [
        {
          "code": "missing_tax_id",
          "message": "SAT RFC (Registro Federal de Contribuyentes) is required for the business",
          "requirementId": "req_01HQ3K4N7XYZABC",
          "resourceType": "business",
          "resourceId": "<string>",
          "affectedField": "taxId"
        }
      ]
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
businessId
string
required
​
filingIds
string[]
required

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

​
fundFromCurrency
string

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

Example:

"USD"

​
metadata
object

Response

Remittance created

​
id
string
Example:

"rem_01HQ3K4N7XYZABC"

​
businessId
string
​
filingIds
string[]

Filings this remittance covers

​
countryCode
string
Example:

"MX"

​
authority
object

The government agency that receives filings and payments.

​
status
enum<string>
pending ──→ processing ──→ completed
                │
                ▼
              failed ──→ pending (retry)

completed ──→ refunded (if amendment reduces amount)
Available options:
pending,
processing,
completed,
failed,
refunded
​
amounts
object
​
paymentMethod
string

How payment was made to the authority

Example:

"Direct bank transfer to SAT via línea de captura"

​
paymentReference
string | null

Government-issued payment reference number

Example:

"SAT-2026-01-RFC-XAXX010101000-ISR"

​
receiptUrl
string<uri> | null

Proof of payment document URL

​
submittedAt
string<date-time> | null
​
completedAt
string<date-time> | null
​
statusHistory
object[]
​
createdAt
string<date-time>
​
updatedAt
string<date-time>