--- title: "Créditos y consumo" description: "Créditos y consumo" type: "faq" category: "question" tags: [] authors: [Anonymous] date: "2026-10-26" last_update: "2026-10-26" time_minutes: 1 draft: false unlisted: false url: "https://www.stage.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, son de cada conexión y el servicio es prepago. El valor vigente está en el [cotizador de precios](https://www.apigateway.cl/pricing). Revisa el detalle en [Créditos](https://www.apigateway.cl/docs/manual/creditos). > [!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**. 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. No es posible ampliarlos ni entregar una segunda tanda. Revisa cómo aprovecharlos en [Créditos de bienvenida](https://www.apigateway.cl/docs/manual/creditos#créditos-de-bienvenida). --- ## ¿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 de la plataforma no cobran, pero una consulta que se ejecuta consume créditos aunque termine en error. # ¿Una consulta que devuelve error consume créditos? Depende de **en qué punto** falle. **No consumen créditos** los rechazos de la plataforma, que ocurren antes de ejecutar la consulta: - Token de conexión inválido o conexión inactiva. - Límite de consultas por minuto excedido (`429`). - IP en uso por otra conexión. - Producto no activo o sin acceso a la operación. - Créditos insuficientes. **Sí consumen créditos** todas las consultas que pasan esas validaciones, aunque el resultado final sea un error. El costo se descuenta antes de ejecutar el recurso y no se devuelve. Por ejemplo: - Un `400` porque la estructura del request no es la que espera el recurso. - Un error de conexión con el proxy. - Un `409` porque el SII respondió con una indisponibilidad. 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 vencen por fecha, no se reembolsan y no se traspasan entre conexiones.** Sí se consumen: mientras la conexión tenga productos activos, el cargo fijo mensual descuenta créditos el día 1 aunque no hagas consultas. Revisa el detalle, y qué hacer si vas a dejar de usar una conexión, en [Vencimiento y reembolsos](https://www.apigateway.cl/docs/manual/creditos#vencimiento-y-reembolsos). --- Última actualización el 26/10/2026