Treli API
Docs
Soporte
    • Introducción
    • Autenticación
    • Errores
    • Códigos de rechazo
    • Límites de solicitudes
    • Suscripciones
      • Suscripción
      • Crear suscripción
        POST
      • Actualizar suscripción
        POST
      • Cancelar suscripción
        POST
      • Obtener suscripción
        GET
      • Eliminar descuento
        DELETE
      • Pausar suscripción
        POST
      • Reanudar suscripción
        POST
      • Listar suscripciones
        GET
      • Migrar suscripción
        POST
    • Items de suscripción
      • Obtener item de suscripción
        GET
      • Eliminar item de suscripción
        DELETE
      • Actualizar item de suscripción
        POST
      • Crear item de suscripción
        POST
    • Clientes
      • Cliente
      • Crear cliente
        POST
      • Actualizar cliente
        POST
      • Obtener cliente
        GET
      • Listar clientes
        GET
      • Registrar pago de facturas
        POST
    • Cobros
      • Cobro
      • Crear cobro
        POST
      • Registrar cobro parcial
        POST
      • Enviar notificación de cobro
        POST
      • Anular cobro
        POST
      • Marcar como incobrable
        POST
      • Pagar un cobro
        POST
      • Obtener un cobro
        GET
      • Listar cobros
        GET
      • Modificar total del cobro
        POST
      • Modificar items del cobro
        POST
      • Modificar descuentos del cobro
        POST
      • Eliminar descuento
        DELETE
      • Marcar cobro como reembolsado
        POST
    • Facturas
      • Cargar factura
      • Obtener factura
      • Listar facturas
      • Anular factura
      • Pagar una factura
    • Notas de crédito
      • Nota de crédito
      • Crear nota de crédito
      • Anular nota de crédito
      • Obtener nota de crédito
    • Productos
      • Crear producto
      • Actualizar producto
      • Obtener un producto
      • Listar productos
      • Eliminar producto
    • Precios
      • Crear precio
      • Actualizar precio
      • Obtener un precio
      • Listar precios
      • Eliminar precio
    • Cargos
      • Listar cargos
    • Enlaces de pago
      • Crear enlace de pago
    • Sesión de checkout
      • Sesión de checkout
      • Crear sesión de checkout
      • Obtener sesión de checkout
    • Sesión de portal
      • Sesión de portal
      • Crear sesión de portal
    • Cupones
      • Cupón
      • Crear cupón
      • Obtener un cupón
      • Eliminar un cupón
      • Actualizar cupón
      • Listar cupones
    • Métodos de pago
      • Listar métodos de pago de un cliente
      • Migrar método de pago
      • Obtener método de pago
      • Eliminar método de pago
    • Pagos de facturas
      • Pago de facturas
      • Listar pagos de facturas
    • Eventos
      • Evento
      • Tipos de eventos
      • Webhooks
    • Catálogo de parámetros por país
      • Colombia
    • Schemas
      • Subscriptions
        • Suscripción
        • Actualizar suscripción
      • Customers
        • Customer
      • Cobros
        • Cobro
      • Facturas
        • Factura
      • Items
      • Producto
      • Precio
      • Descuentos
      • Billing Address
      • Evento
      • Delete object
      • Enlace de pago
      • Sesión de checkout
      • Cupón
      • Pago de facturas
      • Payment information
      • Nota de crédito
      • Transacción
      • Cargo
      • Payment method
      • Sesión de portal

    Límites de solicitudes

    Para proteger la disponibilidad y estabilidad de la API, Treli aplica límites a las solicitudes autenticadas con una clave API.
    Los límites se evalúan continuamente en ventanas móviles de 60 segundos. Dependiendo del endpoint y del patrón de tráfico, pueden aplicarse límites adicionales.
    AlcanceLímite
    Todas las solicitudes autenticadas con clave API1,000 solicitudes por cada 60 segundos
    POST /v1/collections/{id}/pay100 solicitudes por cada 60 segundos
    Las solicitudes realizadas a POST /v1/collections/{id}/pay también cuentan dentro del límite general.
    Nota: Los límites se calculan sobre los 60 segundos anteriores y no se reinician al comenzar un nuevo minuto. Su aplicación puede ser aproximada.

    Cuando se supera un límite#

    Cuando se supera uno de los límites, Treli responde con:
    HTTP/1.1 429 Too Many Requests
    Las solicitudes adicionales podrán rechazarse temporalmente. El acceso se restablece automáticamente cuando el volumen de solicitudes disminuye.
    Tu integración debe detectar esta situación mediante el código HTTP 429, sin depender de que la respuesta incluya un cuerpo JSON específico.

    Cómo gestionar respuestas 429#

    Cuando recibas una respuesta 429:
    Reduce o pausa temporalmente las solicitudes nuevas.
    Reintenta utilizando retroceso exponencial.
    Agrega una variación aleatoria (jitter) entre reintentos.
    Limita la cantidad de solicitudes ejecutadas simultáneamente.
    Evita reintentar todas las solicitudes fallidas al mismo tiempo.
    Una estrategia de reintentos puede esperar aproximadamente 1, 2, 4, 8 y 16 segundos entre intentos sucesivos, hasta alcanzar un tiempo máximo definido por tu integración.

    Operaciones de pago#

    Para POST /v1/collections/{id}/pay, evita enviar múltiples solicitudes simultáneas para el mismo cobro.
    Antes de reintentar una operación de pago, consulta el estado actual del cobro. Esto ayuda a evitar intentos duplicados cuando la respuesta original no pudo ser procesada correctamente por tu integración.

    Integraciones de alto volumen#

    Para procesar grandes cantidades de información:
    Utiliza la paginación de los endpoints de listado.
    Distribuye las solicitudes en el tiempo.
    Controla explícitamente la concurrencia.
    Evita consultar repetidamente recursos que no han cambiado.
    Implementa reintentos únicamente para las solicitudes que realmente fallaron.
    Si esperas mantener un volumen cercano o superior a estos límites, contacta al equipo de soporte de Treli antes de poner la integración en producción.
    Previous
    Códigos de rechazo
    Next
    Suscripción
    Built with