intents

Corregir y reemitir el DTE de un intent

Actualiza el NIT y nombre fiscal, anula el DTE vigente y emite uno nuevo. Usa el ID unificado in_… que devuelve POST /cash_sales y GET /intents/{id}. Funciona también para cash sales.

Si el proveedor no puede anular el DTE vigente, la operación responde 422 con code: void_failed y conserva el documento y los datos fiscales anteriores. Si la anulación termina pero la nueva emisión falla, responde 422 con code: issue_failed; tax_invoice_url queda en null hasta que repitas la operación y la emisión concluya.

Usa un Idempotency-Key único por corrección. Repetir la misma llave y cuerpo reproduce la respuesta anterior sin anular ni reemitir otra vez.

Esta corrección no genera un webhook adicional. Consulta GET /intents/{id} para obtener el tax_invoice_url vigente. En una cuenta conectada, envía también X-ACCOUNT-ID.

put/intents/{intent_id}/tax_invoice

Path parameters

intent_idstring required

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

Request body

Response

DTE corregido y reemitido; devuelve el intent actualizado

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

Sep 2, 2026da12dce50f303See the full diff
- ○
  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

Full history