Obtener factura y líneas de comisiones asumidas

GET

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

GET

/api/connected_account_fee_invoices/:id

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

{
  "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"
    }
  ]
}

Devuelve el DTE agregado y sus líneas inmutables. Cada línea identifica la cuenta conectada, el intento, el pago y los dos componentes del fee. El documento registra dinero debitado al pagar; no crea otro movimiento.

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.

Path parameters

idstringRequired

ID de la factura de comisiones asumidas

Response

Factura con líneas de reconciliación

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

Errors

404

Not Found Error