--- title: "Créditos" description: "Qué es un crédito, las tres formas en que se consume y cómo monitorear el saldo." type: "docs" category: "doc" tags: [] authors: [Anonymous] date: "2026-10-26" last_update: "2026-10-26" time_minutes: 5 draft: false unlisted: false url: "https://www.stage.apigateway.cl/docs/manual/creditos" --- # Créditos El **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, no se comparten ni 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 además incluye un video explicativo del modelo de cobro. Los costos no se listan acá para que siempre consultes el valor vigente. Los saldos y costos se expresan con tres decimales, porque la mayoría de las consultas cuesta una fracción de crédito. > [!WARNING] La coma es separador de decimales > > Cuando la plataforma dice `20,000 créditos` está diciendo **veinte** créditos, no veinte mil. Al comprar, escribir la cantidad con separador de miles genera una cotización por un monto miles de veces mayor al que buscabas. Revisa siempre la cantidad y el monto de la cotización antes de transferir. ## Las tres formas en que se consumen ### 1. Base mensual, el día 1 de cada mes Se descuenta la suma del costo de **cada producto activo** más el **pack de usuarios de autenticación** contratado. Ese total es tu **base mensual**, y lo ves en [Gestionar conexión → Productos](https://app.apigateway.cl/connections/manage#products) como *"Base mensual estimada (tu selección)"*. Si el día 1 tu saldo no cubre la base **completa**, la conexión se suspende. No hay cobro parcial. Al comprar créditos después de una suspensión, el sistema cobra solo el **proporcional de los días que quedan** del mes y reactiva la conexión automáticamente. ### 2. Cada consulta a la API **Además** de la base mensual, cada llamada descuenta el costo de su operación. Tener el producto activo te da **acceso** a los recursos; no incluye las consultas. El costo varía según lo que la operación implica del lado del SII: una consulta simple cuesta mucho menos que una que descarga y procesa un documento. El detalle por recurso está en el [cotizador](https://www.apigateway.cl/pricing) y en la [documentación de la API](https://www.apigateway.cl/docs/api). ### 3. Usuarios de autenticación adicionales Cada credencial distinta con que te autentiques en el SII, más allá de las incluidas en tu pack, descuenta créditos una vez por período. Revisa [Productos y límites](https://www.apigateway.cl/docs/manual/productos-y-limites). ## Créditos de bienvenida 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 rápido si activas varios productos, porque la activación cobra de inmediato. 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. No es posible ampliarlos ni entregar una segunda tanda. Y crear cuentas o conexiones adicionales para acumularlos provoca el **bloqueo de las cuentas involucradas**, conforme a los [términos y condiciones](https://www.apigateway.cl/legal). ## Qué consultas consumen créditos **No consumen** los rechazos de la plataforma, que ocurren antes de ejecutar la consulta: token inválido, conexión inactiva, límite de consultas excedido (`429`), IP en uso por otra conexión, producto no activo o créditos insuficientes. **Sí consumen** todas las consultas que pasan esas validaciones, aunque terminen en error: el costo se descuenta antes de ejecutar el recurso y no se devuelve. Esto incluye los `400` por una estructura del request inválida, los errores de conexión con el proxy y el `409` por indisponibilidad del SII. ## Cómo monitorear el saldo - La cabecera **`X-Stats-Credits-Remaining`** viene en las respuestas de la API. Léela en tu integración y dispara una alerta interna cuando el saldo baje de tu base mensual. - El [dashboard de la conexión](https://app.apigateway.cl/connections/dashboard) muestra el consumo por consulta y por día. - El **historial de eventos de la conexión** registra los descuentos mensuales y las activaciones de productos. Revisa [Dashboard y registros](https://www.apigateway.cl/docs/manual/dashboard-y-registros). ## Vencimiento y reembolsos Los créditos **no caducan por fecha**, pero se consumen: mientras haya productos activos, la base mensual descuenta créditos cada día 1 aunque no hagas consultas. Una conexión inactiva con productos activos va agotando su saldo hasta suspenderse. **No hay reembolsos** de créditos comprados ni consumidos, y **no se traspasan** entre conexiones. Revisa los [términos y condiciones](https://www.apigateway.cl/legal). > [!TIP] Si vas a dejar de usar una conexión por un tiempo > > Desactivar los productos y dejar en 1 los usuarios de autenticación 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 26/10/2026