Referencia APIIntents

Listar intents (formato unificado)

Devuelve los intents de la cuenta en formato normalizado, del más reciente al más antiguo. El payload usa el mismo formato que GET /intents/{id} y que los webhooks unificados intent.*. Para intents de tipo payment, la razón de fallo se devuelve en details.failure_reason.

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. 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

from_timedatetimeOptional

Inicio del rango de creación. Si se envía como fecha sin hora, se interpreta como el inicio del día. Se aplica solo junto con until_time.

until_timedatetimeOptional

Fin del rango de creación. Si se envía como fecha sin hora, se interpreta como el final del día. Se aplica solo junto con from_time.

Response

Lista de intents en formato normalizado
typeenum
Tipo de pago subyacente
idstringformat: "^in_"

ID del intent unificado; es la llave canónica para GET /intents/{id} y los eventos intent.*.

statusenum

Estado normalizado. paid aplica solo al evento del pagador en pagos con balance (type balance).

raw_statusstring

Estado concreto sin normalizar (ej. requires_capture)

receipt_numberintegerOptional
api_versionstringOptional
created_atdatetimeOptional
amount_in_centsintegerOptional
currencystringOptional
customer_idstringOptional
user_idstringOptional
customerobjectOptional
Datos del cliente
productobjectOptional
Producto principal
tax_invoice_urlstring or nullOptionalformat: "uri"

En la API devuelve la URL actual del DTE; en un webhook refleja el valor disponible al entregar ese evento y puede ser null aunque una emisión posterior tenga éxito.

checkoutobject or nullOptional
paymentobject or nullOptional
detailsobjectOptional

Campos específicos del tipo de pago. Para type: payment, incluye failure_reason, comisiones, cuotas, canal y productos. Para type: bank_transfer, incluye bank_reference (referencia asignada por el banco o la red de pago) y sender_comment (comentario libre del pagador).