Desarrolladores

Es la sección donde encontrarás todas las herramientas necesarias para integrar T1 Pagos en tu sitio web, aplicación móvil o sistema mediante nuestra API REST.

Aquí puedes gestionar tus claves de API (públicas y privadas), configurar webhooks para recibir notificaciones automáticas de eventos, y acceder a la documentación técnica completa.

Encuentra documentación necesaria para integrar tu negocio con T1 Pagos.

Haz click aquí para acceder a la documentación completa de la API.

¿Qué es la Sección de Desarrolladores?

La sección de Desarrolladores te proporciona acceso a las credenciales de API y herramientas necesarias para que tu equipo técnico pueda integrar los servicios de T1 Pagos directamente en tu plataforma.

Con la API de T1 Pagos puedes:

• Procesar pagos directamente desde tu sitio web o app
• Crear links de pago programáticamente
• Consultar el estado de transacciones en tiempo real
• Gestionar clientes y tarjetas guardadas
• Recibir notificaciones automáticas de eventos (webhooks)
• Automatizar procesos de reembolso y cancelación

Claves de API

T1 Pagos utiliza dos tipos de claves para autenticar tus solicitudes a la API:

Llave Pública

La llave pública se utiliza del lado del cliente para tokenizar la información sensible de las tarjetas antes de enviarla a sus servidores. Es seguro exponerla en tu código JavaScript ya que solo permite tokenizar datos, no procesar pagos.

Importante

No uses la llave pública para procesar pagos directamente. Esta llave solo debe usarse para tokenizar información de tarjetas en el navegador del cliente. Para procesar pagos, usa la llave privada en tu servidor.

Llaves Privadas

Crea llaves privadas para limitar los permisos a las diferentes áreas de datos y transacciones de tu negocio.

Las llaves privadas se utilizan del lado del servidor (backend) para autenticar todas tus solicitudes a la API de T1 Pagos. Nunca expongas estas llaves en tu código frontend o repositorios públicos.

Puedes crear múltiples llaves privadas con diferentes permisos para distintos servicios o equipos de desarrollo.

Acciones Disponibles:

• Editar: Modificar el nombre y permisos de la llave
• Eliminar: Revocar permanentemente el acceso de esta llave

Crear Nueva Llave Privada

Al crear una nueva llave privada, puedes configurar permisos específicos para limitar qué operaciones puede realizar:

1. Nombre de llave

Asigna un nombre descriptivo para identificar fácilmente el propósito de esta llave.

2. Activar todos los permisos

Puedes habilitar todos los permisos con un solo clic, o seleccionar permisos específicos manualmente.

Activar todos los permisos

3. Selecciona los permisos que quieres activar

Webhooks

Los webhooks son notificaciones HTTP automáticas que T1 Pagos envía a tu servidor cuando ocurren eventos importantes. En el sistema T1 Pagos algunos procesos son ejecutados de manera automática, como es el caso de los cobros de las suscripciones.

Para mantener sincronizados los sistemas, puedes configurar un endpoint para recibir notificaciones de eventos como nuevos cargos, renovación de suscripciones y otros. Puedes incluir más de un endpoint y canalizar las notificaciones a cada nueva ruta.

Los webhooks te permiten automatizar acciones en tu sistema cuando suceden eventos en T1 Pagos.

• Actualizar el estado de una orden cuando se completa el pago
• Enviar un email de confirmación al cliente
• Activar el acceso a un producto digital
• Registrar transacciones en tu sistema contable
• Sincronizar suscripciones con tu base de datos
• Generar facturas automáticamente

Seguridad en Recepción de Eventos

En la configuración de recepción de eventos puedes habilitar autenticación para añadir una capa de seguridad adicional:

• Basic Auth: Autenticación básica con usuario y contraseña. El sistema validará estas credenciales en cada webhook recibido.
• Bearer Token: Token de autenticación enviado en el header Authorization. Más seguro que Basic Auth.
  Recomendado para: APIs públicas o con alta seguridad

Reintentos y Periodicidad

T1 Pagos permite configurar cómo y cuándo se envían las notificaciones:

• Máximo de intentos: Define cuántas veces T1 Pagos reintentará enviar el webhook si falla (máximo 10 intentos)
• Frecuencia de reintentos: Tiempo en minutos entre cada reintento (máximo 60 minutos)
• Periodicidad: Elige si el webhook se envía inmediatamente, cada 5 minutos o cada hora

Acciones disponibles

• Editar: Modificar configuración del webhook
• Eliminar: Eliminar el webhook permanentemente
• Activar/Desactivar: Pausar temporalmente sin eliminar