Skip to navigation

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.

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

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
Allowed values:
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).

Allowed values:
raw_statusstring

Estado concreto sin normalizar (ej. requires_capture)

legacy_idstringOptional

ID del mismo pago en el formato anterior de webhooks por tipo. Permite vincular registros históricos al migrar a eventos unificados; el ID canónico sigue siendo id.

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"

Public page for the payment’s final certified tax document (invoice, receipt, or donation receipt). Exempt accounts default to receipts; NGOs default to donation receipts and can choose receipts in invoicing settings. The page links to the certifier’s copy; tax_invoice_uuid remains the authorization number. API responses return the current value. Webhooks reflect the value available when delivered and may contain null even if certification succeeds later.

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