> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sistema de Facturación

> Precios de pago por uso, niveles de planes y gestión de uso para su organización Truthlocks.

Truthlocks utiliza un modelo de facturación de pago por uso en el que solo paga por lo que consume. Cada organización (inquilino) tiene su propia suscripción, contadores de uso y ciclo de facturación. Las características y cuotas se aplican según su plan activo.

## Niveles de planes

* **Centrado en el inquilino**: Cada inquilino (Organización) tiene su propia suscripción y ciclo de facturación.
* **Derechos**: Las características y cuotas se aplican en función de la clave de plan activa (`plan_developer`, `plan_starter`, `plan_business`, `plan_institutional`, `plan_enterprise`).
* **Multiprovedor**: Enrutamos los pagos a través de diferentes pasarelas (Stripe, Paystack, Flutterwave) dependiendo de la jurisdicción legal del inquilino.
* **Precios Regionales**: El proceso de pago utiliza automáticamente el país de su cuenta para aplicar las tarifas y la moneda regionales correctas. Consulte [enrutamiento de proveedores](https://docs.truthlocks.com/es/billing/provider-routing.md) para más detalles.

## Niveles de planes

> [card] Desarrollador
>
> Para aficionados y proyectos de prueba de concepto. Incluye verificación en línea y soporte comunitario sin costo.

> [card] Inicial
>
> Para PYMES y startups con cargas de trabajo de producción. Cuotas más altas, hasta 3 endpoints de webhook y procesamiento prioritario.

> [card] Negocio
>
> Para equipos de mercado medio con necesidades de cumplimiento. SSO SAML, aprovisionamiento SCIM, RBAC completo y registros de auditoría, hasta 10 endpoints de webhook y un SLA de soporte de 4 horas.

> [card] Institucional
>
> Para grandes empresas con necesidades de seguridad avanzadas. Registro de transparencia privado, integración HSM y un SLA de soporte de 1 hora.

> [card] Empresarial
>
> Precios personalizados para gobiernos y empresas Fortune 500. SLA personalizado, opciones de implementación en las instalaciones, soporte 24/7 y onboarding a medida.

## Conceptos básicos

* **Derechos** — cada plan desbloquea características y cuotas específicas (límites de acuñación, recuentos de verificación, asientos, almacenamiento, límites de tasa de API). El servicio de facturación aplica estos límites en la capa de API.
* **Contadores de uso** — los medidores disponibles se informan para el ciclo de facturación seleccionado. Puede monitorear su consumo desde el panel de uso de la consola o la [API de uso](https://docs.truthlocks.com/es/api-reference/billing/usage.md).
* **Enrutamiento multiproveedor** — los pagos se procesan a través de la pasarela óptima para su región. Consulte [enrutamiento de proveedores](https://docs.truthlocks.com/es/billing/provider-routing.md) para más detalles.

## Productos medidos

Truthlocks mide 16 productos organizados en cuatro categorías. Puede verlos todos en la [página de precios](https://www.truthlocks.com/pricing) y rastrear su consumo en la consola en **Configuración > Facturación > Uso**.

### Núcleo

| Producto | Descripción | Tasa predeterminada |
| :- | :- | :- |
| Acuñaciones de atestación | Atestaciones creadas a través de la API o SDK | \$0.25 por acuñación |
| Verificaciones | Solicitudes de verificación de atestación | \$0.10 por verificación |
| Almacenamiento | Almacenamiento total de archivos y pruebas consumido | Incluido por plan |
| Paquetes de prueba | Paquetes de prueba criptográfica generados | Incluidos por plan |
| Puntos finales de webhook | Registros de puntos finales de webhook activos | Incluido por plan |
| Entregas de webhook | Intentos individuales de entrega de webhook | Incluido por plan |
| Asientos | Asientos de miembros del equipo en su organización | Incluido por plan |

### MAIP (Identidad de máquina)

| Producto | Descripción | Tasa predeterminada |
| :- | :- | :- |
| Agentes | Agentes de máquina registrados | Por nivel de plan |
| Sesiones | Sesiones de agente creadas por mes | Por nivel de plan |
| Cálculos de puntuación de confianza | Cálculos de puntuación de confianza bajo demanda | Por nivel de plan |
| Controles de cumplimiento | Solicitudes de verificación de cumplimiento | Por nivel de plan |

### IA

| Producto | Descripción | Tasa predeterminada |
| :- | :- | :- |
| Atestaciones de conjuntos de datos | Conjuntos de datos atestiguados para el seguimiento de linaje | Por nivel de plan |
| Atestaciones de modelos | Modelos de ML atestiguados para la procedencia | Por nivel de plan |

### Antifraude

| Producto | Descripción | Tasa predeterminada |
| :- | :- | :- |
| Señales de riesgo | Señales de fraude ingeridas o generadas | Por nivel de plan |
| Escaneos de deepfake | Solicitudes de escaneo de deepfake e suplantación de identidad | Por nivel de plan |
| Registros de velocidad | Registros de acción de puntuación de velocidad | Por nivel de plan |

> [!NOTE]
>
> Consulte la [página de precios](https://www.truthlocks.com/pricing) para ver los precios publicados. La API de factura proyectada actualmente calcula el precio de las acuñaciones y verificaciones; otros productos necesitan su acuerdo de precios aplicable.

## Tarifas

Las tarifas por uso para acuñaciones y verificaciones son:

| Operación | Tasa |
| :- | :- |
| Acuñación de atestación | \$0.25 por acuñación |
| Verificación | \$0.10 por verificación |

Las tarifas son visibles en la consola en **Configuración > Facturación > Uso**.

> [!NOTE]
>
> Las tarifas se redujeron en un 50% en la versión de marzo de 2026. Las tarifas anteriores eran de $0.50 por acuñación y $0.20 por verificación.

### Tarifas personalizadas para socios

Los administradores de la plataforma pueden crear tarjetas de tarifas personalizadas con precios por operación para los inquilinos asociados. Utilice esto para ofrecer precios negociados a socios estratégicos o clientes de volumen sin cambiar las tarifas de su plan estándar.

Cada tarjeta de tarifas define precios unitarios para acuñaciones y verificaciones, y se puede asignar a uno o más inquilinos con una fecha de entrada en vigor.

Las tarifas negociadas se aplican a cada operación de producción facturable mientras el acuerdo esté vigente. Un límite de recursos no es una asignación gratuita. Las asignaciones gratuitas para desarrolladores, las suscripciones de consumidores, la actividad de sandbox y los pilotos aprobados sin cargo son independientes de los precios comerciales negociados.

Las bandas de volumen son graduadas: si las primeras 100 operaciones cuestan $0.25 cada una y las operaciones subsiguientes cuestan $0.20, 101 operaciones cuestan \$25.20. Una banda posterior no vuelve a fijar el precio de las operaciones anteriores. Las bandas deben cubrir la cantidad total sin huecos ni solapamientos.

Una tarifa de asociación con descuento no es un piloto gratuito. Un piloto aprobado tiene una fecha de caducidad y límites de uso, sin conversión pagada automática.

> [!NOTE]
>
> El uso aceptado ahora se registra en un libro mayor inmutable y separado por entornos con su tarifa, país y instantánea del plan. Los precios se fijan en el momento de la aceptación por el servicio de facturación, no los proporciona una marca de tiempo de relleno del llamante. Los nuevos precios no vuelven a valorar los registros aceptados. Los contadores agregados antiguos no se facturan retroactivamente.
>
> Los meses UTC cerrados producen borradores de factura automáticamente. Un borrador no es pagadero: su emisión requiere MFA del personal, un contrato de factura de moneda coincidente activo, país de facturación verificado, confirmación del acuerdo del cliente y revisión fiscal explícita. Este flujo de trabajo no carga los métodos de pago guardados ni envía correos electrónicos. Los fondos verificados recibidos se registran por separado, con verificaciones de referencia duplicada y saldo pendiente.
>
> Los planes gratuitos, los planes de consumidor, la actividad de sandbox y los pilotos aprobados sin cargo están excluidos del uso comercial tarifado. La falta de evidencia de entorno o precios para las operaciones centrales retiene el mes afectado para revisión. La liquidación automática actualmente soporta el catálogo de tarifas denominado en USD, incluyendo sus descuentos regionales; otras monedas se retienen para revisión.

### Proyecciones de uso

La página de uso de la consola muestra el consumo registrado y su tarjeta de tarifas actual. La API de factura proyectada autenticada estima los costos de acuñación y verificación utilizando la tarjeta de tarifas estándar; no resuelve tarifas negociadas privadas, impuestos, asignaciones gratuitas o una factura emitida.

Navegue a **Configuración > Facturación > Uso** para inspeccionar el uso y las tarifas. Lea las facturas emitidas por separado.

## Cuotas de derechos

Su plan determina las siguientes cuotas:

| Cuota | Desarrollador | Starter | Business | Institucional | Enterprise |
| :- | :- | :- | :- | :- | :- |
| Acuñaciones de atestación | 500/mes | Mayor | Personalizado | Personalizado | Personalizado |
| Verificaciones mensuales | Depende del plan | Depende del plan | Depende del plan | Depende del plan | Depende del plan |
| Emisores | 1 | Múltiples | Personalizado | Personalizado | Depende del plan |
| Asientos | 1 | Múltiples | Personalizado | Personalizado | Personalizado |
| Claves de firma | 1 | Múltiples | Personalizado | Personalizado | Dependiente del plan |
| Puntos finales de webhook | 1 | 3 | 10 | 25 | 25+ |
| Almacenamiento | 1 GB | Mayor | Personalizado | Personalizado | Personalizado |
| Límite de velocidad de API | 60 solicitudes/min | Mayor | Personalizado | Personalizado | Personalizado |
| SSO y SCIM | — | — | Incluido | Incluido | Incluido |
| Registro de transparencia privado | — | — | — | Incluido | Opcional |
| Integración HSM | — | — | — | Incluida | Opcional |
| SLA de soporte | Comunidad | Correo electrónico en 48 horas | 4 horas | 1 hora | Personalizado |

## Complementos

Puede adjuntar complementos a su plan para obtener capacidades adicionales. Los complementos se facturan por separado y se suman a los derechos de su plan base.

| Complemento | Clave | Precio base | Lo que desbloquea |
| :- | :- | :- | :- |
| Asientos adicionales | `addon_seat` | \$25/asiento/mes | +1 miembro del equipo por unidad más allá del límite de su plan. Admite cantidad: establezca el número de asientos adicionales que necesita al finalizar la compra. |
| SLA Prioritario | `addon_sla_priority` | \$199/mes | Actualización a SLA con tiempo de respuesta de 4 horas |
| Registro Privado | `addon_private_log` | \$499/mes | Espacio de nombres de registro de transparencia dedicado |
| Paquete de cumplimiento | `addon_compliance` | \$299/mes | Informes de cumplimiento de SOC 2, GDPR y HIPAA |
| Marca blanca | `addon_whitelabel` | \$199/mes | Eliminar la marca Truthlocks de las páginas de verificación |
| Aumento de límite de tasa | `addon_ratelimit` | \$149/mes | 10 veces los límites de tasa de API predeterminados |
| Retención extendida | `addon_retention` | \$99/mes | Retención de registro de auditoría de 10 años (el valor predeterminado es 2 años) |

Administre los complementos en la consola en **Configuración > Facturación > Complementos**. El mercado de complementos muestra todos los complementos disponibles con su precio regional, una descripción y un botón de adjuntar con un solo clic. Los complementos que admiten cantidad (como Asientos adicionales) le permiten elegir el número de unidades antes de comprar.

También puede verificar sus complementos activos y derechos resueltos a través de la API:

```bash theme={null}
curl https://api.truthlocks.com/v1/billing/entitlements \
  -H "X-API-Key: tl_live_..."
```

```json theme={null}
{
  "plan_key": "plan_starter",
  "features": {
    "online_verification": true,
    "offline_bundles": true,
    "custom_metadata": true,
    "sso_scim": false
  },
  "quotas": {
    "attestations.mint": 5000,
    "seats": 4,
    "api_rate_limit": 1200,
    "storage_bytes": 10737418240,
    "webhook_endpoints": 3
  }
}
```

> [!NOTE]
>
> Los precios de los complementos se ajustan automáticamente según su región y proveedor de pagos. Los complementos gratuitos (como Asientos Extra en planes Enterprise) se activan inmediatamente sin un paso de pago.

### Precios de complementos regionales

Los precios de los complementos se ajustan automáticamente según el país de su organización. El sistema de facturación agrupa los países en niveles de precios y aplica un multiplicador al precio base.

| Región | Multiplicador | Países |
| :- | :- | :- |
| Nivel 1 | 1.0x (precio completo) | EE. UU., GB, DE, FR, CA, AU, NL, CH, JP, SG, IE, IT, ES, SE, NO, DK, FI, NZ |
| LATAM | 0.7x | BR, MX, AR, CO, CL, PE |
| MENA | 0.8x | AE, SA, EG, IL, TR, ZA |
| Sudeste Asiático | 0.6x | ID, TH, VN, PH, MY |
| África | 0.5x | NG, KE, GH, TZ, UG, RW |
| Asia del Sur | 0.5x | IN, PK, BD, LK |

Por ejemplo, el complemento Compliance Pack con un precio base de $299/mes cuesta $149.50/mes para un inquilino en Nigeria (multiplicador de 0.5x).

Los multiplicadores regionales también se aplican a las tarifas por uso para emisiones y verificaciones. Un inquilino en India (0.5x) paga $0.125 por emisión y $0.05 por verificación en lugar de las tarifas estándar de $0.25 y $0.10. Puede verificar sus tarifas efectivas con el [punto final de tarifas](https://docs.truthlocks.com/es/api-reference/billing/rates.md).

> [!TIP]
>
> Utilice el selector de país en la página de complementos para previsualizar los precios de una región específica. El selector no cambia su país de facturación, solo ajusta los precios mostrados.

## Facturación por orden de compra

Los inquilinos empresariales pueden pagar mediante orden de compra como alternativa a la tarjeta de crédito o a los proveedores de pago regionales.

**1. Enviar una orden de compra**

Navega a **Configuración > Facturación** y selecciona la opción de orden de compra.
Suba su documento de pedido (PDF), introduzca el número de pedido, el importe y la fecha de caducidad
fecha.

**2. Revisión y activación**

El equipo de facturación de Truthlocks revisa su pedido. Una vez aprobado, su cuenta
se activa y se emiten facturas contra el saldo de la orden de compra.

**3. Seguimiento del estado de la orden de compra**

Vea el estado del pedido, el saldo restante y las facturas asociadas desde el
página de configuración de facturación.

> [!NOTE]
>
> La facturación por orden de compra está disponible en el plan Enterprise. Contacte a su
> gerente de cuenta si necesita pago basado en PO en un plan diferente.

## Exportación contable

Los inquilinos empresariales pueden exportar su historial de facturas como CSV o JSON para contabilidad y conciliación. Las exportaciones incluyen el número de factura, el estado, las fechas de emisión y vencimiento, los importes, los impuestos, la moneda y las referencias de PO. Si no se proporciona un rango de fechas, la exportación se establece de forma predeterminada en los últimos 30 días.

```bash theme={null}
curl "https://api.truthlocks.com/v1/billing/exports/accounting?format=csv&from=2026-01-01&to=2026-06-30" \
  -H "X-API-Key: tl_live_..."
```

| Parámetro | Tipo | Descripción |
| :- | :- | :- |
| `format` | string | Formato de exportación: `csv` o `json`. Por defecto es `csv`. |
| `from` | string | Fecha de inicio (`YYYY-MM-DD`, por ejemplo `2026-01-01`). Por defecto, 30 días atrás. |
| `to` | string | Fecha de finalización (`YYYY-MM-DD`, p. ej. `2026-06-30`). Por defecto es hoy. |

La respuesta transmite el archivo directamente. Para las exportaciones CSV, el `Content-Type` es `text/csv` con una cabecera `Content-Disposition` para la descarga.

También puede exportar facturas desde la consola en **Configuración > Facturación > Facturas > Exportar**.

> [!NOTE]
>
> La exportación contable está disponible en el plan Enterprise. La exportación incluye todos
> facturas dentro del rango de fechas especificado, incluidas las facturas pagadas, abiertas y anuladas
> facturas.

## Fallos de pago y períodos de gracia

Si un pago falla, Truthlocks sigue un flujo de trabajo de acceso gradual para que tenga tiempo de resolver el problema antes de perder el acceso. Puede verificar su estado de facturación actual en cualquier momento a través del endpoint [`GET /v1/billing/status`](https://docs.truthlocks.com/es/api-reference/billing/status).

```bash theme={null}
curl https://api.truthlocks.com/v1/billing/status \
  -H "X-API-Key: tl_live_..."
```

```json theme={null}
{
  "status": "ACTIVE",
  "feature_mode": "NORMAL",
  "grace_until": null,
  "banner": null
}
```

El estado de facturación progresa a través de tres etapas cuando un pago falla:

| Etapa | `feature_mode` | Ventana de gracia predeterminada | Qué sucede |
| :- | :- | :- | :- |
| **Degradado** | `DEGRADED` | 7 días | Falló el pago. Comienza un período de gracia y aparece un banner en la consola. Todas las funciones permanecen disponibles mientras actualiza su método de pago. |
| **Restringido** | `RESTRICTED` | 14 días | El período de gracia se está agotando. Las operaciones de escritura (acuñación, creación de claves) están deshabilitadas. Las operaciones de lectura y verificación siguen funcionando. |
| **Suspendido** | `SUSPENDED` | — | Período de gracia expirado. Todo el acceso a la API está deshabilitado hasta que se resuelva el pago. |

El campo `grace_until` muestra la marca de tiempo ISO 8601 cuando finaliza el período de gracia actual. Resuelva el pago antes de esta fecha para restaurar el acceso completo automáticamente. Las ventanas de gracia anteriores se aplican al modo de contrato Estándar; los modos Empresarial y Gubernamental utilizan ventanas más largas. Consulte [modos de contrato](#contract-modes) para obtener más detalles.

### Modos de contrato

El comportamiento del ciclo de vida de cobro depende del modo de contrato del inquilino. Por defecto, todos los inquilinos usan el modo Estándar, pero los administradores de la plataforma pueden cambiar un inquilino a un modo diferente desde la consola de operaciones de facturación.

| Modo | Reintentos | Período de gracia | Cuándo usar |
| :- | :- | :- | :- |
| **Estándar (Automático)** | Reintentos automáticos en T+24h, T+48h, T+72h | 7 días (Degradado) luego 14 días (Restringido) antes de la suspensión | Inquilinos de autoservicio que pagan con tarjeta de crédito o proveedor de pago regional |
| **Empresarial (Manual)** | Sin reintentos automáticos — el administrador de facturación interviene | 21 días (Degradado) luego 28 días (Restringido) — ventanas estándar más 14 días adicionales | Cuentas empresariales que pagan por transferencia bancaria o orden de compra |
| **Gubernamental (Sin reintentos)** | Sin reintentos automáticos | Período de gracia fijo de 90 días; sin suspensión automática | Flujos de trabajo de contratación gubernamental donde los plazos de pago están fuera de su control |

El modo Estándar envía hasta tres recordatorios de pago en intervalos de 24, 48 y 72 horas después de cada transición de etapa. Los modos Empresarial y Gubernamental omiten por completo los reintentos automáticos; un administrador de facturación debe resolver el pago manualmente.

> [!NOTE]
>
> Los cambios en el modo de contrato se registran en la auditoría y requieren un motivo. Póngase en contacto con el soporte para solicitar un cambio en el modo de contrato.

Al usar el [punto final de estimación](https://docs.truthlocks.com/es/api-reference/billing/estimate.md), puede pasar `contract_mode` como `ENTERPRISE_CONTRACT` o `GOVERNMENT_PROCUREMENT` para obtener una recomendación de plan que tenga en cuenta el tipo de contrato. Omitir este campo predetermina a `STANDARD_SELF_SERVE`.

> [!TIP]
>
> Verifique `feature_mode` en su integración para mostrar las indicaciones de actualización o pago.
> a sus usuarios antes de que se restrinja el acceso. Se incluye un mensaje `banner` cuando
> se necesita acción. Consulte la [referencia de la API de estado de facturación](https://docs.truthlocks.com/es/api-reference/billing/status.md) para obtener detalles completos de la respuesta y ejemplos de uso.

## Gestión de la facturación

Todas las configuraciones de facturación se administran en la consola en **Configuración > Facturación**. Desde allí puede:

* Ver su plan actual y sus derechos
* Monitorear contadores de uso y consumo de tarifas
* Actualizar o degradar su plan
* Ver y descargar facturas
* Exportar facturas para contabilidad (Enterprise)
* Enviar órdenes de compra (para cuentas empresariales)
* Adjuntar o separar complementos

## Comprobación de límites a través de la API

Antes de realizar una operación facturable, puede verificar si su cuota actual lo permite:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/billing/limits/check \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{"metric": "attestations.mint", "amount": 1}'
```

La respuesta indica si la operación está permitida bajo su plan actual:

```json theme={null}
{
  "allowed": true,
  "used": 158,
  "limit": 500,
  "delta": 1
}
```

### Extensiones del período de gracia en las comprobaciones de límites

Si su uso excede el límite de su plan, pero un administrador de la plataforma ha otorgado un período de gracia para esa métrica, la respuesta incluye un objeto `grace` con los detalles de la asignación temporal:

```json theme={null}
{
  "allowed": true,
  "used": 510,
  "limit": 500,
  "grace": {
    "active": true,
    "amount": 100,
    "expires_at": "2026-04-15T12:00:00Z"
  },
  "delta": 1
}
```

## Relacionado

> [card] [Gestión de suscripciones](https://docs.truthlocks.com/guides/subscription-management.md)
>
> Suscríbase, actualice, adjunte complementos y cancele a través de la API.

> [card] [Enrutamiento del proveedor](https://docs.truthlocks.com/billing/provider-routing.md)
>
> Cómo se enrutan los pagos por región.

> [card] [Listar planes](https://docs.truthlocks.com/api-reference/billing/plans.md)
>
> Obtenga los niveles de plan disponibles con precios y características.

> [card] [Obtener tarifas](https://docs.truthlocks.com/api-reference/billing/rates.md)
>
> Sus tarifas efectivas por uso con ajustes regionales.

> [card] [Estimar costos](https://docs.truthlocks.com/api-reference/billing/estimate.md)
>
> Obtenga una recomendación de plan basada en el uso esperado.

> [card] [API de estado de facturación](https://docs.truthlocks.com/api-reference/billing/status.md)
>
> Verifique el estado de su facturación, el modo de funciones y el período de gracia.

> [card] [Referencia de la API de facturación](https://docs.truthlocks.com/api-reference/billing/config.md)
>
> Configuración, derechos, pago, suscripción y puntos finales de factura.

> [card] [API de uso](https://docs.truthlocks.com/api-reference/billing/usage.md)
>
> Verifique sus contadores de uso del ciclo de facturación actual.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.