Introducción
Onboarding de comerciantes significa más que completar un formulario: los productos deben estar disponibles, el tracking configurado, las conversiones validadas y las reglas de comisión definidas. Affilentra conecta estos pasos en un entorno self‑hosted en el que operadores, comerciantes y socios tienen roles separados. Este artículo muestra concretamente cómo configurar webhooks, reglas de validación y pedidos de prueba automatizados en Affilentra (PRO & NETWORK) para que los comerciantes sean incorporados a su red de socios de forma rápida, segura y sin errores.
¿Por qué un onboarding dirigido por webhooks?
Los webhooks permiten integrar sistemas externos (tienda, ERP, proveedor de pagos) por eventos en Affilentra. En lugar de entradas manuales o importes programados, responde inmediatamente a eventos relevantes como la creación de un comerciante, actualizaciones de productos o eventos de pedidos. Combinado con validaciones automatizadas y pedidos de prueba, esto reduce la tasa de errores, acorta los tiempos de procesamiento y aumenta la trazabilidad para comerciantes y socios.
Pasos preparatorios (lista de verificación antes de la implementación técnica)
- Instalar una instancia self‑hosted de Affilentra (PRO o NETWORK).
- Asegurarse: HTTPS, acceso para operadores del software y administradores, entorno PHP/MySQL actualizado.
- Aclarar la información disponible del comerciante: URL de la tienda, acceso API, catálogo de productos, modelos de comisión deseados.
- Definir qué eventos deberían disparar webhooks (p. ej. merchant.created, product.updated, order.created, order.status_changed).
- Esbozar roles y permisos: qué acciones pueden realizar comerciantes, socios y operadores.
Configuración de webhooks en Affilentra
Affilentra ofrece en PRO & NETWORK la posibilidad de configurar webhooks para eventos a nivel del sistema y específicos de comerciante. Proceda de la siguiente manera:
- Crear endpoint de webhook: Registrar un nuevo webhook en el área de administración y almacenar la URL de destino del sistema externo.
- Selección de eventos: Seleccione eventos de forma dirigida, p. ej. merchant.created, merchant.updated, product.synced, order.created. Limite la selección a lo estrictamente necesario para reducir el tráfico.
- Configurar seguridad: Active firmas HMAC con un secreto compartido. Affilentra firma los payloads y los sistemas externos verifican la firma antes de procesar.
- Estrategia de reintentos: Defina el número de intentos de reenvío y la estrategia de backoff para que fallos temporales no provoquen pérdida de datos.
- Idempotencia: Use IDs de evento únicas en el payload para que los receptores detecten reintentos y eviten procesamientos duplicados.
Notas prácticas
Documente la estructura de payload esperada para su equipo de tienda o ERP. Los campos habituales son merchant_id, shop_url, products (con SKU, precio, disponibilidad) y signatur_meta. Nombres de campo claros y tipos de datos reducen el trabajo de coordinación.
Reglas de validación: configurar reglas de campo y de negocio
Las reglas de validación protegen su red frente a datos erróneos o incompletos. Affilentra permite comprobaciones configurables en varios niveles:
- Comprobaciones de esquema: Campos obligatorios, tipos de datos y límites de longitud (p. ej., shop_url debe ser HTTPS válido, SKU no debe estar vacío).
- Reglas de negocio: Ejemplo: los tipos de comisión deben coincidir con los productos, los métodos de pago seleccionados deben estar habilitados para el comerciante.
- Validación dependiente del contexto: Reglas que solo se aplican a ciertas categorías de comerciantes o mercados (p. ej., valor mínimo de conversión para determinados programas de socios).
Implemente las validaciones como parte del proceso de procesamiento del webhook. En caso de entradas erróneas, Affilentra envía automáticamente una retroalimentación a los sistemas de origen (Webhook‑Response) y registra el mensaje de error en la interfaz de usuario para operadores y comerciantes.
Pedidos de prueba automatizados: validar el tracking y la lógica de comisiones
Los pedidos de prueba son clave para comprobar las rutas de tracking y los cálculos de comisiones antes de que un comerciante entre en producción. Así debería implementar pedidos de prueba en Affilentra:
- Activar modo de prueba: Establezca para el comerciante un estado de prueba en el que los pedidos se marquen como pruebas y no desencadenen pagos reales.
- Payloads de simulación: Cree órdenes de prueba estandarizadas que cubran distintos escenarios: conversión exitosa, cancelación, reembolso parcial, devolución de cargo.
- Desencadenamiento automatizado: Active pedidos de prueba vía webhook desde la tienda o mediante la API de Affilentra. Los pedidos de prueba deben contener los mismos parámetros de tracking que las órdenes en vivo (p. ej., affiliate_id, campaign_id, click_id).
- Informes y seguimiento: Los pedidos de prueba aparecen en el historial de pedidos con el estado de validación y el cálculo de comisiones, para que comerciantes y operadores detecten desviaciones.
Implemente un flujo de prueba breve: enviar order de prueba → comprobar la validación → verificar el cálculo de comisiones → restablecer la order de prueba o migrarla a producción si todo es correcto.
Mapeo de roles y permisos
Un elemento central en el onboarding es la separación clara de roles. Affilentra distingue entre operadores de software, comerciantes y socios. Configure los roles de la siguiente manera:
- Operador del software: Acceso total a la configuración del sistema, gestión de webhooks, administración de licencias y reglas globales de validación.
- Comerciante: Control sobre productos, precios, creatividades, condiciones y webhooks específicos del comerciante; visualización de liquidaciones de comisiones para sus propios programas.
- Socio (Publisher/Creator): Enlaces de seguimiento personales, historial transparente de conversiones y pagos, acceso a creatividades.
Las reglas de mapeo definen qué permisos predeterminados recibe un comerciante recién creado. En PRO & NETWORK puede crear plantillas que se asignan automáticamente junto con eventos de webhook (p. ej. categoría de comerciante A → cierto modelo de comisión + acceso API restringido).
Canal de incorporación de extremo a extremo: ejemplo de flujo
Un flujo típico y automatizado con Affilentra es el siguiente:
- La tienda envía merchant.created → Affilentra crea el comerciante y verifica los datos básicos (comprobaciones de esquema).
- Affilentra dispara merchant.validation_failed/merchant.validation_passed al sistema de la tienda y al operador.
- Si la comprobación es satisfactoria, se inician sincronizaciones de productos mediante product.synced; se ejecutan reglas de validación para productos.
- Se generan automáticamente pedidos de prueba (order.created con test_flag); se comprueba el seguimiento y la lógica de comisiones.
- Tras una prueba exitosa, el comerciante recibe el estado Live; los socios obtienen enlaces de seguimiento personalizados y pueden lanzar campañas.
Monitoreo, registros y manejo de errores
Utilice el registro en Affilentra: los eventos de webhook, los errores de validación y los pedidos de prueba deben ser visibles en el panel. Configure reglas de alarma para errores recurrentes (p. ej. sincronizaciones de producto fallidas) y defina reglas de escalado hacia el operador.
Ejemplo práctico: inicio rápido para un nuevo comerciante
Flujo concreto en pocos pasos:
- Enviar los datos del comerciante mediante el webhook merchant.created a Affilentra.
- Affilentra valida los campos obligatorios; si faltan datos, la API de la tienda recibe un objeto de error detallado.
- Si las comprobaciones son exitosas, se sincronizan los datos de productos y se generan automáticamente una serie de pedidos de prueba.
- Los resultados de las pruebas se muestran en el portal del comerciante; el operador revisa la aprobación y pone al comerciante en Live.
- Los socios reciben automáticamente enlaces de seguimiento para el nuevo programa del comerciante y ven conversiones de prueba y en vivo en su historial.
Conclusión y recomendaciones de actuación
La incorporación impulsada por webhooks reduce tareas manuales y permite procesos transparentes y reproducibles. Con Affilentra se asegura que las reglas de validación y los pedidos de prueba sean parte integral del onboarding — y que los roles permanezcan claramente separados. En la práctica esto significa: menos errores de contabilización, un time-to-market más rápido y pagos comprensibles para todas las partes implicadas.
Siguiente paso: Revise su lista de comprobación de onboarding, defina los eventos de webhook necesarios y cree pedidos de prueba estandarizados. Si desea utilizar Affilentra, elija el punto de entrada adecuado para su organización.
Siguiente paso
Probar Affilentra por sí mismo
Plataforma unificada que reúne de forma transparente la publicación de productos, el seguimiento, la validación de conversiones, el cálculo de comisiones y los pagos a lo largo de roles claramente separados; opción de instalación self-hosted con licencia permanente sin participación en los ingresos; los comerciantes conservan el control sobre productos, condiciones y materiales promocionales; los socios reciben enlaces de seguimiento personales e historial de pagos rastreable.