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.
Authentication
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.
Path parameters
Request
Response
DTE corregido y reemitido; devuelve el intent actualizado
ID del intent unificado; es la llave canónica para GET /intents/{id} y los eventos intent.*.
Estado normalizado. paid aplica solo al evento del pagador en pagos con balance (type balance).
Estado concreto sin normalizar (ej. requires_capture)
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.
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).