Listar facturas de comisiones asumidas por la plataforma

GET

https://app.recurrente.com/api/connected_account_fee_invoices

GET

/api/connected_account_fee_invoices

curl https://app.recurrente.com/api/connected_account_fee_invoices \
     -H "X-SECRET-KEY: <apiKey>"

200Retrieved

[
  {
    "id": "cafi_ab12cd34",
    "status": "draft",
    "billing_date": "2026-07-13",
    "currency": "GTQ",
    "amount_in_cents": 725,
    "description": "Comisiones de cuentas conectadas del 13/07/2026",
    "created_at": "2024-01-15T09:30:00Z",
    "updated_at": "2024-01-15T09:30:00Z",
    "tax_invoice_uuid": "string",
    "tax_invoice_url": "https://app.recurrente.com/f/340B4ACC-0435-4BE5-8EBD-9F4D92AED618",
    "issued_at": "2024-01-15T09:30:00Z",
    "lines": [
      {
        "connected_account_id": "ac_restaurant",
        "intent_id": "in_ab12cd34",
        "payment_id": "pa_ab12cd34",
        "processor_fee_in_cents": 1,
        "recurrente_fee_in_cents": 1,
        "amount_in_cents": 1,
        "currency": "GTQ",
        "paid_at": "2024-01-15T09:30:00Z",
        "created_at": "2024-01-15T09:30:00Z"
      }
    ]
  }
]

Lista los DTE diarios emitidos por Recurrente a la plataforma por las comisiones de cobro que pagó para sus cuentas conectadas. La lista no incluye líneas; consulta el detalle para reconciliar cada cobro.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Query parameters

pageintegerOptional>=1Defaults to 1

Número de página (empezando en 1)

itemsintegerOptional1-100Defaults to 10

Elementos por página

Response

Lista de facturas de comisiones asumidas

idstring

ID de la factura diaria de comisiones asumidas

statusenum

Estado durable del documento fiscal

Allowed values:

billing_datedate

Día económico en America/Guatemala

currencyenum

Allowed values:

amount_in_centsinteger>=1

Suma de las comisiones de procesamiento y Recurrente incluidas

descriptionstring

created_atdatetime

updated_atdatetime

tax_invoice_uuidstring or nullOptional

UUID del DTE emitido por INFILE

tax_invoice_urlstring or nullOptionalformat: "uri"

Página de la factura en Recurrente, la representación gráfica del DTE con la marca del comercio. El documento con validez fiscal es el certificado ante la SAT, y la página enlaza a la copia del certificador. tax_invoice_uuid sigue siendo el número de autorización si necesitas construir ese enlace por tu cuenta.

issued_atdatetime or nullOptional

lineslist of objectsOptional

Solo se incluye en el endpoint de detalle