intents

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.

get/intents/{id}

Path parameters

idstring required

ID del intent

Headers

X-SECRET-KEYstring required

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.

Response

Intent en formato normalizado

type'payment' | 'bank_transfer' | 'crypto' | 'balance' | 'cash' required

Tipo de pago subyacente

idstring required

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

receipt_numberinteger
api_versionstring
status'pending' | 'succeeded' | 'failed' | 'canceled' | 'paid' required

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

raw_statusstring required

Estado concreto sin normalizar (ej. requires_capture)

created_atstring date-time
amount_in_centsinteger
currencystring
customer_idstring
user_idstring
customerIntentCustomer

Datos del cliente

productIntentProduct

Producto principal

tax_invoice_urlstring uri nullable

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.

paymentIntentPayment

Changes

Changed in 1 of the 2 revisions of this API.3

    • added the optional property // to the response with the status

      response-optional-property-added

    • added the optional property // to the response with the status

      response-optional-property-added

    • added the optional property // to the response with the status

      response-optional-property-added