Listar facturas de comisiones de una cuenta conectada

GET

https://app.recurrente.com/api/connected_accounts/:connected_account_id/commission_invoices

GET

/api/connected_accounts/:connected_account_id/commission_invoices

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

[
  {
    "id": "pci_ab12cd34",
    "connected_account_id": "ac_restaurant",
    "status": "draft",
    "billing_date": "2026-07-13",
    "currency": "GTQ",
    "amount_in_cents": 325,
    "description": "Comisiones de plataforma del 13/07/2026",
    "created_at": "2024-01-15T09:30:00Z",
    "updated_at": "2024-01-15T09:30:00Z",
    "fee_in_cents": 25,
    "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": [
      {
        "transfer_setup_id": "string",
        "transfer_id": "string",
        "source_id": "string",
        "source_type": "Checkout",
        "amount_in_cents": 1,
        "currency": "GTQ",
        "completed_at": "2024-01-15T09:30:00Z",
        "created_at": "2024-01-15T09:30:00Z"
      }
    ]
  }
]

Lista los documentos diarios, más recientes primero. La lista no incluye las líneas; consulta el documento individual para reconciliar cada transferencia de origen. El emisor conserva acceso a este historial si la cuenta deja de estar conectada.

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

connected_account_idstringRequired

ID de la cuenta conectada

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

idstring

ID de la factura diaria de comisiones

connected_account_idstring

Cuenta conectada que debe pagar la comisión

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 exacta de las comisiones incluidas, en centavos

descriptionstring

created_atdatetime

updated_atdatetime

fee_in_centsinteger or nullOptional

Fee FEL debitado a la plataforma después de una emisión exitosa

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