Referencia APIIntents

Obtener un intent (formato unificado)

Recurso Intent unificado: devuelve el formato normalizado para cualquier tipo de pago (payment, bank_transfer, crypto, balance, cash), discriminado por el campo type.

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

Path parameters

idstringRequired
ID del intent

Response

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

Errors

404
Not Found Error