Si tu programa de fidelización funciona en otro sistema, puedes enviar a JeriCommerce el saldo y el nivel de cada cliente para que su tarjeta de fidelización los muestre. Se hace con el mismo endpoint que los datos de cliente, usando loyalty como función. Acepta una matriz de hasta 250 objetos en el cuerpo de la solicitud.
POST https://api.jericommerce.com/v1/programs/{program_slug}/integrations/api
Este endpoint forma parte de la integración API personalizada. Necesita que la integración esté activa en Settings > Integrations > API, con la función Loyalty activada. Si no, responde 403 con API_INTEGRATION_REQUIRED o API_LOYALTY_REQUIRED.
Para sumar puntos a un programa de fidelización de JeriCommerce en lugar de reemplazar el saldo, usa Increase balance.
El cliente debe existir antes de añadir su información de fidelización. Si no existe, el elemento de fidelización se omite sin mostrar ningún error.
Puedes enviar los datos del cliente y de fidelización en una misma solicitud, pero debes mantener el orden e incluir primero la información del cliente.
Este es un ejemplo del cuerpo para actualizar un cliente:
[
{
"email": "{{customer_email}}",
"feature": "loyalty",
"payload": {
"loyaltyCustomerId": "{{customer_loyalty_id}}",
"balance": "{{balance_to_apply}}",
"memberSince": "{{customer_join_date}}",
"tierStatus": "{{customer_tier}}"
}
}
]
Propiedades del payload ¶
loyaltyCustomerId ¶
Es la referencia externa de los datos de fidelización y sirve para asociarlos a otra base de datos.
Es obligatoria en cada solicitud. Se guarda la primera vez y se mantiene después.
Balance ¶
El saldo del cliente es una de las propiedades más importantes. Nuestra API no calcula el valor: reemplaza el saldo por el importe que se proporciona en la solicitud.
El campo es obligatorio. Envíalo como un número igual o mayor que 0. Los decimales se redondean al entero más cercano.
memberSince ¶
Es la fecha en que el cliente se registró en el programa de fidelización, en formato ISO 8601 (por ejemplo, 2026-01-31).
Es opcional. Si no la envías, JeriCommerce mantiene la fecha actual, o usa la de hoy si el cliente es nuevo.
tierStatus ¶
Según la configuración del programa, puede haber niveles o no. Si los hay, puedes indicar aquí el nombre del nivel.
Esta propiedad de texto es opcional; puede contener el valor que quieras asignar.
Response ¶
La respuesta sigue las mismas reglas que el endpoint de clientes: 201 cuando se guardan todos los elementos. Cuando cambia el saldo o el nivel, el cliente recibe una notificación en su wallet si tiene esas notificaciones activadas.
El catálogo de recompensas del programa tiene su propio endpoint: List rewards.