--- title: "Créditos y consumo" description: "Créditos y consumo" type: "faq" category: "question" tags: [] authors: [Anonymous] date: "2026-09-11" last_update: "2026-09-11" time_minutes: 1 draft: false unlisted: false url: "https://www.apigateway.cl/faq/creditos-y-consumo" --- # Créditos y consumo --- ## ¿Qué es un crédito? El crédito es la unidad de consumo del servicio; su valor y los costos están en el cotizador. # ¿Qué es un crédito? Es la unidad con que se mide y se cobra todo en API Gateway. - Se compran en **números enteros**, con un mínimo por compra que la plataforma indica al generar el cobro. - Son **de la conexión**: cada conexión tiene su propio saldo y no se traspasan entre conexiones. - El servicio es **prepago**: no hay saldo negativo ni facturación a posteriori. > [!INFO] Dónde ver el valor del crédito y los costos > > El valor del crédito, el costo mensual de cada producto y el costo por consulta de cada recurso están en el [cotizador de precios](https://www.apigateway.cl/pricing), que incluye además un video explicativo del modelo de cobro. Ahí siempre verás el valor vigente. Los saldos se muestran con tres decimales, porque la mayoría de las consultas cuesta una fracción de crédito. > [!WARNING] La coma es separador de decimales > > `20,000 créditos` son **veinte**, no veinte mil. Revisa [Cuando dice 20,000 créditos, ¿son veinte o veinte mil?](https://www.apigateway.cl/faq/creditos-y-consumo/la-coma-es-separador-de-decimales). --- ## ¿Cómo se cobra el servicio? Hay una parte fija mensual por los productos contratados y una parte variable por cada consulta. # ¿Cómo se cobra el servicio? El cobro tiene **dos partes**, y confundirlas es el origen de la mayoría de las dudas. **1. Una parte fija mensual.** El día 1 de cada mes se descuenta el costo de cada **producto activo** más el **pack de usuarios de autenticación** contratado. Esa suma es tu **base mensual** y la ves en [Gestionar conexión → Productos](https://app.apigateway.cl/connections/manage#products). Si ese día el saldo no la cubre, la conexión se suspende. **2. Una parte variable por consulta.** **Además** de la base mensual, cada llamada a la API descuenta el costo de su operación. Tener el producto activo te da **acceso** a los recursos; no incluye las consultas. A eso se suma el costo de cada **usuario de autenticación adicional**, una vez por período. Revisa [Productos y límites](https://www.apigateway.cl/docs/manual/productos-y-limites). > [!TIP] Estima tu caso completo > > El [cotizador](https://www.apigateway.cl/pricing) te permite armar tu combinación de productos, indicar cuántas consultas harás por recurso y ver el costo mensual total, con el valor vigente de cada uno. --- ## ¿Qué son los créditos de bienvenida y por qué se agotaron tan rápido? Sirven para una prueba de concepto y suelen consumirse al activar productos, no al hacer consultas. # ¿Qué son los créditos de bienvenida y por qué se agotaron tan rápido? Al crear tu primera conexión recibes créditos de bienvenida, pensados para una **prueba de concepto**: validar que los recursos entregan lo que tu sistema necesita. Se agotan sin haber hecho consultas porque **activar productos consume créditos de inmediato**, y varios productos juntos pueden costar más que el total de los créditos de bienvenida. Cómo aprovecharlos: 1. **Revisa la documentación antes de la primera llamada.** Una consulta mal armada consume créditos igual y devuelve un error. 2. **Activa solo el producto que vas a probar**, no todos. Revisa antes el costo en el [cotizador](https://www.apigateway.cl/pricing). 3. **No desactives el producto para "recuperar" créditos**: no se devuelven, y volver a activarlo cobra de nuevo. > [!WARNING] No se entregan más créditos de prueba > > No es posible ampliarlos ni entregar una segunda tanda. Y crear cuentas o conexiones adicionales para acumularlos provoca el bloqueo de las cuentas involucradas. --- ## ¿Cuándo se descuenta la base mensual y qué pasa si no tengo saldo? Se descuenta el día 1 de cada mes; si el saldo no la cubre, la conexión se suspende hasta que cargues créditos. # ¿Cuándo se descuenta la base mensual y qué pasa si no tengo saldo? El descuento ocurre el **día 1 de cada mes**, de forma automática, por el total de los productos activos más el pack de usuarios contratado. Si el saldo no alcanza, la conexión **se suspende** ese mismo día y la API responde `La conexión está inactiva.` No hay cobro parcial: o se descuenta la base completa, o la conexión queda suspendida. Para reactivarla, compra créditos suficientes. Al procesarse el pago el sistema descuenta **el proporcional de los días que quedan** del mes —no la base completa— y reactiva la conexión automáticamente. Cómo evitarlo: - Mantén saldo suficiente **antes del día 1**. - Monitorea la cabecera `X-Stats-Credits-Remaining` de las respuestas exitosas. > [!INFO] Si el cobro se aplica en otra fecha > > Excepcionalmente puede ejecutarse con retraso respecto al día 1 por un ajuste en la tarea programada. En ese caso queda registrado con su fecha real en el historial de eventos de la conexión. --- ## Activé y desactivé productos y se consumieron mis créditos, ¿se pueden recuperar? Los créditos consumidos al activar un producto no se reembolsan, y volver a activarlo lo cobra otra vez. # Activé y desactivé productos y se consumieron mis créditos, ¿se pueden recuperar? **No.** Los créditos consumidos no se reembolsan, conforme a los [términos y condiciones](https://www.apigateway.cl/legal). La mecánica, que no es intuitiva: - **Activar** un producto descuenta créditos en el momento, proporcional a los días que restan del mes. - **Desactivar** no cuesta nada, pero **tampoco devuelve** lo cobrado. - **Volver a activarlo** lo cobra otra vez, aunque sea el mismo mes y el mismo producto. La plataforma lo advierte al guardar: > ¿Estás seguro de querer actualizar los productos y usuarios de autenticación? Los créditos consumidos no se reembolsarán, según las políticas explicadas en los Términos y Condiciones. > [!TIP] Qué hacer en su lugar > > Antes de activar nada, usa el [cotizador](https://www.apigateway.cl/pricing): muestra qué recursos incluye cada producto y cuánto cuesta, es gratis y no consume créditos. --- ## Cuando dice 20,000 créditos, ¿son veinte o veinte mil? En la plataforma la coma es separador de decimales, por lo que 20,000 créditos son veinte créditos. # Cuando dice 20,000 créditos, ¿son veinte o veinte mil? Son **veinte**. La coma es el **separador de decimales**, no de miles. Los créditos se muestran con tres decimales: | La plataforma dice | Significa | |---|---| | `20,000` créditos | 20 créditos | | `15,600` créditos | 15,6 créditos | | `0,615` créditos | poco más de medio crédito | ## Por qué esto importa tanto Al comprar créditos, escribir la cantidad con separador de miles genera una cotización por un monto **miles de veces mayor** al que buscabas. Hemos atendido casos de cotizaciones por decenas y cientos de miles de créditos cuando el usuario quería unas decenas. Cuando eso ocurre, la transferencia por el monto pequeño no coincide con la cotización y el pago no se puede validar. > [!TIP] Revisa la cotización antes de transferir > > La cotización muestra la cantidad de créditos y el monto exacto, y la plataforma también muestra la cantidad en texto. Si el monto no es el que esperabas, elimina el cobro en [Gestionar conexión → Cobros](https://app.apigateway.cl/connections/manage#charges) y genera uno nuevo. --- ## ¿Por qué me descontaron más créditos de lo que indica el cotizador? Casi siempre por un usuario de autenticación adicional, por el cargo mensual o por la activación de un producto. # ¿Por qué me descontaron más créditos de lo que indica el cotizador? Tres causas posibles, en orden de frecuencia: **1. Un usuario de autenticación adicional.** Si consultas con una credencial del SII que no habías usado antes en el período, se descuentan créditos además del costo de la operación. Se cobra una sola vez por usuario y por período. Revisa [Productos y límites](https://www.apigateway.cl/docs/manual/productos-y-limites). **2. El cargo fijo mensual.** El día 1 de cada mes se descuenta la base mensual de tus productos. Revisa [¿Cuándo se descuenta la base mensual?](https://www.apigateway.cl/faq/creditos-y-consumo/cuando-se-descuenta-la-base-mensual). **3. La activación de un producto**, que descuenta su costo en el momento, proporcional a los días que restan del mes. ## Cómo verificarlo tú mismo El **historial de eventos de la conexión** registra los descuentos mensuales y las activaciones con fecha y monto, y el [dashboard](https://app.apigateway.cl/connections/dashboard) muestra el costo de cada consulta. Revisa [¿Dónde veo el historial de mi conexión?](https://www.apigateway.cl/faq/conexiones/donde-veo-el-historial-de-mi-conexion). Si después de revisar ambos la diferencia sigue sin explicarse, [genera un ticket](https://www.apigateway.cl/help) indicando la fecha y hora del movimiento. --- ## ¿Una consulta que devuelve error consume créditos? Depende de dónde falle: los rechazos previos al SII no cobran, pero una consulta que llega al SII sí puede consumir. # ¿Una consulta que devuelve error consume créditos? Depende de **en qué punto** falle. **No consumen créditos** los rechazos que ocurren antes de llegar al SII: - Token de conexión inválido. - Producto no activo o sin acceso a la operación. - Créditos insuficientes o IP en uso por otra conexión. **Sí pueden consumir créditos** las consultas que se procesaron y llegaron al SII, incluso si el resultado final es un error. Por ejemplo, un `409` porque el SII respondió con una indisponibilidad: la operación se ejecutó y el costo se descontó. Para saber cuánto costó cada llamada, la cabecera `X-Stats-Credits-Remaining` indica el saldo restante, y el [dashboard de la conexión](https://app.apigateway.cl/connections/dashboard) muestra el detalle de cada consulta con los créditos que consumió. > [!TIP] Esto es la razón para leer la documentación primero > > Validar la estructura del request en la [documentación interactiva](https://www.apigateway.cl/docs/api) antes de automatizar evita gastar créditos en errores. --- ## ¿Los créditos vencen? ¿Se pueden reembolsar o traspasar? No se reembolsan ni se traspasan entre conexiones, y el saldo se consume mes a mes con el cargo fijo. # ¿Los créditos vencen? ¿Se pueden reembolsar o traspasar? **No se reembolsan.** Los créditos comprados y los consumidos no se devuelven en dinero, conforme a los [términos y condiciones](https://www.apigateway.cl/legal). **No se traspasan entre conexiones.** El saldo pertenece a la conexión en que se compró. **No caducan por una fecha**, pero sí se consumen: mientras la conexión tenga productos activos, el **cargo fijo mensual** descuenta créditos el día 1 de cada mes, incluso si no hiciste ninguna consulta. Una conexión inactiva con productos activos va agotando su saldo hasta suspenderse. > [!TIP] Si vas a dejar de usar una conexión por un tiempo > > Desactivar los productos detiene el cargo fijo mensual, y desactivar no tiene costo. El saldo restante queda disponible. Ten presente que volver a activarlos se cobra de nuevo. --- Última actualización el 11/09/2026