Saltar al contenido principal
Puede gestionar todo su ciclo de vida de facturación a través de la API o la consola. Esta guía cubre cómo listar planes, estimar costos, crear una sesión de pago, verificar su suscripción, adjuntar complementos y cancelar cuando sea necesario.

Requisitos previos

  • Una cuenta de Truthlocks con un inquilino activo.
  • Una clave API con permisos de facturación. Consulte Claves API para crear una.

Elegir un plan

Truthlocks ofrece cinco niveles de planes. Utilice el endpoint de planes para obtener el catálogo completo; este es un endpoint público y no requiere autenticación.
Consulte descripción general de facturación para una comparación de todos los planes.

Estimar sus costos

Antes de suscribirse, use el endpoint de estimación para obtener una recomendación de plan basada en su uso esperado. Este también es un endpoint público.
La respuesta incluye un plan recomendado y un total mensual estimado. Para un desglose de costos por partida, utilice el punto final factura proyectada en su lugar.

Consultar sus tarifas actuales

Las tarifas efectivas por uso de su inquilino dependen de su lista de precios y región. Obténgalas con:
La respuesta incluye tarifas base y cualquier ajuste de precios regional:
Si su organización tiene una tarjeta de tarifas personalizada asignada por un administrador de plataforma, esas tarifas aparecerán aquí en lugar de las predeterminadas.

Suscribirse a un plan

Cree una sesión de pago para iniciar o actualizar su suscripción. El servicio de facturación selecciona automáticamente el proveedor de pago correcto para su región.
1

Crear una sesión de pago

Llame al endpoint de pago con el plan que desea y las URL de redireccionamiento:
La respuesta contiene una checkout_url alojada por el proveedor de pagos.
2

Redirigir a la caja

Envíe al usuario a checkout_url para completar el pago.
3

Confirmar la suscripción

Después del pago, verifique que la suscripción esté activa:
Opcionalmente, puede pasar un parámetro provider (stripe, paystack o flutterwave) para anular el enrutamiento automático basado en la región. Consulte enrutamiento del proveedor para obtener más detalles.

Adjuntar complementos

Los complementos amplían su plan con capacidades adicionales. Adjúntelos a través de la API:
Si el complemento tiene un precio, la respuesta incluye un checkout_url para completar el pago. Los complementos gratuitos se activan inmediatamente.
Los precios de los complementos se ajustan automáticamente según el país de facturación de su organización. Los inquilinos en regiones de menor costo pagan una tarifa reducida; por ejemplo, el Paquete de Cumplimiento cuesta $149.50/mes en Nigeria (multiplicador de 0.5x) en lugar del precio base de $299. Consulte precios regionales de complementos para ver la tabla de niveles completa.
Para eliminar un complemento:
Consulte administrar complementos para obtener el catálogo completo de complementos y los detalles de la respuesta.

Monitorear el uso

Rastree el consumo de su ciclo de facturación actual para mantenerse dentro de los límites de su plan:
Para verificar si una operación específica está dentro de la cuota antes de realizarla:

Abrir el portal de facturación

Redirija a los usuarios al portal de autoservicio de su proveedor de pagos para actualizar los métodos de pago, ver facturas o administrar su suscripción:
La respuesta incluye un portal_url. Redirija al usuario a esa URL. Las sesiones del portal caducan rápidamente, así que genere una URL nueva cada vez.

Cancelar una suscripción

Para cancelar, llame al endpoint de cancelación. La cancelación se hará efectiva al final del período de facturación actual; mantendrá acceso completo hasta entonces.
Una vez finalizado el período, su cuenta se degrada al plan Desarrollador (gratuito). Para volver a suscribirse, cree una nueva sesión de pago.
No puede deshacer una cancelación a través de la API. Para reanudar su suscripción, debe volver a pasar por el proceso de pago.

Relacionado

Resumen de facturación

Planifica niveles, tarifas, derechos y complementos.

Enrutamiento del proveedor

Cómo se enrutan los pagos por región.

Referencia de la API de facturación

Referencia completa del endpoint de la API de facturación.

Derechos

Verifique sus funciones y cuotas activas.