API REST
Toda conexión con el motor de promociones y con el de lealtad es vía API REST.
Para desarrolladores
Nos conectamos a tu stack. No al revés.
Payloot se integra vía API REST con la arquitectura que ya opera en tu organización. Aquí está lo que hay detrás de la consola, cómo se conecta y hasta dónde llega.
# Una condición, un beneficio IF order.subtotal >= 1500 && customer.segment == 'vip' AND NOT order.items.contains('restricted_category') THEN trigger.benefit({ type: 'gift_with_purchase', sku: 'premium_glass' }) > STATUS: regla evaluada y aprobada para checkout #9012
# Conecta tu motor POST /api/v1/promotions/sync { "cart": { ... }, "customer": { ... } } > 200 OK
# Recálculo de órdenes POST /v1/recalculo { "order_id": "8821", "picker_substitute": true, "items": [ ... ] } > 200 OK - recalculated
Ejemplos ilustrativos. La referencia completa se comparte con tu equipo al solicitar acceso.
Una API en medio de lo que ya tienes.
Tus canales consultan a la API de Payloot. Payloot resuelve con sus motores y se conecta, mediante conectores, con tu ERP, tu OMS o tu motor corporativo.
Tus canales
Ecommerce
App
Punto de venta
Monederos digitales
Payloot
API REST
Motor de reglas
Motor de lealtad
Recálculo
Tus sistemas
ERPSAP o a la medida
OMSGestión de órdenes
Motor corporativoSi conectas el tuyo
Seis decisiones de arquitectura.
Lo que explica cómo se comporta Payloot cuando lo conectas a tu operación.
Evaluación en vivo
Cada carrito se evalúa con las reglas vigentes en ese momento, sin resultados guardados.
Cambios al instante
Una regla nueva se refleja en todos los canales sin esperar sincronizaciones por lotes.
Transacciones independientes
Abono y redención de lealtad se registran por separado, lo que simplifica auditorías y reversos.
Nivel de línea
Promociones y mensajes se calculan por línea de producto, no solo sobre el total.
Jerarquías recursivas
Payloot lee la estructura de tiendas desde tu ERP para desplegar reglas por rama.
Documentación pública, acompañamiento donde importa.
Las APIs públicas tienen documentación detallada para que tu equipo integre por su cuenta. Lo especializado se habilita con nuestro equipo.
APIs especializadas
Las APIs de uso especializado, como las cargas masivas, se habilitan con acompañamiento técnico directo para proteger el rendimiento de la plataforma.
Lo que revisamos con tu equipo técnico
- Evaluar un carrito y aplicar un cupón.
- Abonar y redimir saldo de lealtad.
- Generar códigos de referido.
- Recalcular una orden modificada.
- Autenticación, límites de uso, versionado y entorno de pruebas.
Toda integración empieza con un mapeo de campos.
Relacionas los campos de tu sistema con los que Payloot necesita para evaluar promociones, o para abonar y redimir saldo.
| En tu sistema (ejemplo) | Lo que Payloot necesita | Para qué lo usa |
|---|---|---|
| Código de artículo | SKU | Identificar los productos que participan en cada regla |
| Precio de lista | Precio | Calcular el descuento y su prorrateo |
| Unidades en el carrito | Cantidad | Evaluar promociones NxM y escalonadas |
| ID de cliente o socio | Cliente | Segmentos, niveles y límites de uso por cliente |
| Canal de venta | Canal | Aplicar promociones distintas en tienda y en línea |
| Sucursal | Tienda | Regionalización y despliegue por jerarquía |
Tabla ilustrativa. Los nombres de campo reales dependen de tu sistema.
Hecho para alto volumen.
El motor está diseñado para altos volúmenes de transacciones en canales en línea.
Cupones por día—
Transacciones por segundo—
Disponibilidad—
Caché y carga en tu infraestructura
¿Payloot usa caché?
Payloot no responde con resultados guardados. Cada carrito se evalúa contra las reglas vigentes en ese momento, así que lo que ve tu cliente es siempre la promoción real.
Si conectas tu propio motor
Cada consulta llega hasta tu motor en tiempo real, así que necesita una infraestructura robusta. Si no está preparado para ese volumen, nuestro equipo puede diseñar una capa de caché que lo proteja, sin sacrificar la precisión del carrito.
Si usas Payloot como motor
La infraestructura la aporta Payloot. Como cada carrito se evalúa en tiempo real, los costos de infraestructura varían según tu volumen.
Controles desde el diseño.
Decisiones de producto que protegen tus datos, tu margen y tu operación.
Sin BIN bancarios
Por seguridad, los BIN bancarios no se usan dentro de la plataforma.
Cliente identificado
Las promociones agresivas exigen que el cliente se identifique para validar su elegibilidad y su historial.
Bitácora de auditoría
Cada cambio en las reglas queda registrado con usuario y fecha. Ver bitácora
Qué incluye y qué no.
Para que sepas desde el inicio qué resuelve la plataforma, qué requiere servicios profesionales y qué no está disponible.
| Capacidad | Estado |
|---|---|
| Promociones de todo tipo en todos los canales | Incluido |
| Recálculo de órdenes con pago con tarjeta | Incluido |
| Recálculo con otros métodos de pago | Con servicios profesionales |
| Diferencia de precio del sustituto | Con servicios profesionales |
| Caché para motores de terceros | Con servicios profesionales |
| Conectores fuera de SAP, VTEX y Oracle Commerce | Con servicios profesionales |
| Meses sin intereses como promoción | No aplica: es un tipo de pago |
| Promociones por BIN bancario | No disponible, por seguridad |
Revisemos tu integración con un ingeniero
Solicita acceso a la documentación o cuéntanos qué sistemas usas y armamos el plan de conexión.