Registrar una venta cobrada en efectivo
Registra una venta cobrada en efectivo. No mueve dinero por Recurrente: no se descuenta comisión, no impacta el balance del merchant, y no se genera transacción en el ledger. Si pasas tax_id, se intenta emitir la factura electrónica (DTE) automáticamente.
La respuesta devuelve el ID del recurso unificado (in_…). Persiste ese ID para reconciliar el evento intent.succeeded y para consultar el estado actual mediante GET /intents/{id}. También aparece como checkout.latest_intent.id; solo el id superior del evento legacy cash_intent.succeeded usa el ID concreto del CashIntent (ca_…).
tax_invoice_url en los webhooks refleja el estado del DTE al momento de la entrega. Puede ser null si la emisión todavía no concluyó o falló y luego se recupera. Ese cambio no genera un segundo webhook de éxito; recupera la URL actual con GET /intents/{id}.
Si operas una plataforma, envía X-ACCOUNT-ID tanto al crear como al consultar para que la venta y su DTE pertenezcan a la cuenta conectada y se emitan bajo su NIT. X-CUSTOM-ACCOUNT-ID no selecciona el contexto de lectura.
Headers
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
Venta en efectivo registrada
Changes
No recorded changes to this endpoint across all 1 revision of this API.