---
title: 'Políticas de canje'
description: 'Cómo loyalty decide cuánto del saldo del cliente se puede usar en un pedido: qué políticas aplican, el tope de cada una, el modo de agrupación y la competencia entre políticas.'
---

# Políticas de canje

Cuando un pedido solicita un canje (por ejemplo, en [Recompensa por pedido](/docs/{lang}/api-reference/loyalty/checkout/reward-by-order)), loyalty tiene que decidir **qué** cards del cliente se usan y **cuánto** de cada uno. Esta guía explica esa decisión paso a paso, con ejemplos.

## Conceptos

- **Card** (`rewardCard`) — cada crédito que el cliente ganó (cashback, bono, puntos). Tiene su propio saldo y vigencia.
- **Política de canje** (también llamada **cartera** o `wallet`) — el conjunto de reglas que define **dónde** y **cuánto** de ese saldo se puede usar. Todo card pertenece a una política; el campo `wallet` del card es el id de la política.

La campaña define en qué política nacen los cards que genera. Dos campañas en la misma política generan saldo en la misma cartera.

## Paso 1 — Qué políticas aplican a este pedido

Una política solo participa si **todas** las condiciones siguientes se cumplen:

| Condición | Qué se verifica |
|---|---|
| Tienda | La tienda del pedido está vinculada a la política. |
| Canje activo | La política tiene el canje activado. |
| Etiquetas | El cliente tiene todas las etiquetas requeridas y ninguna de las excluidas. |
| Nivel | El nivel del cliente está entre los permitidos (o fuera de los excluidos). |
| Mínimo dinámico | Si la política exige una compra mínima proporcional al saldo (`minOrderRate`), el pedido debe alcanzarla. Si no la alcanza, la cartera queda fuera y el motivo viene en `redeemable.blocked`. |

Los cards de una política que no pasó este paso no se usan, aunque tengan saldo.

## Paso 2 — El tope de cada política

Cada política calcula **el descuento máximo que acepta en este pedido**, considerando solo los artículos que autoriza (categorías y colecciones permitidas, sin las colecciones excluidas):

- **Valor mínimo / máximo** (`minOrderTotal` / `maxOrderTotal`) — si el total de los artículos autorizados queda fuera del rango, la política no otorga descuento.
- **Límite** (`maxOrderRate`) — hasta `1`, es un porcentaje: `0.3` = hasta el 30% de los artículos autorizados. Arriba de `1`, es un valor fijo en centavos (vea [Valores monetarios](/docs/{lang}/guides/monetary-values)): `5000` = hasta $50.00. Sin límite, aplica el total de los artículos autorizados.

El tope es **de la política**: sus cards, juntos, nunca lo superan.

## Paso 3 — Dentro de la política: el modo de agrupación

El modo de agrupación de la política define cómo se combinan **sus propios cards**:

| Modo | Comportamiento dentro de la política |
|---|---|
| **Agregar** (`aggregate`) | Suma todos los cards de la política, hasta el tope. |
| **Único** (`single`) | Usa **un** solo card: el que da el mayor descuento. |
| **Mixto** (`mixed`) | Igual que Agregar. Se mantiene para políticas ya configuradas así. |

El modo que se usa es el **actual** de la política. Cambiar el modo también aplica a los cards que ya existen.

## Paso 4 — Entre políticas: compiten, nunca se suman

Si el cliente tiene saldo en **más de una política válida** para el pedido, las políticas **compiten entre sí**. El pedido usa **solo una**:

1. Gana la política que da el **mayor descuento** en este pedido (ya aplicados el tope del paso 2 y el modo del paso 3).
2. En caso de **empate**, gana la que tiene el card con la **vigencia más próxima**, para que el cliente no pierda saldo.

El saldo de políticas diferentes **nunca se suma** en el mismo pedido. Para que dos saldos se sumen, los cards deben estar en la **misma política**, es decir, las campañas que los generan deben apuntar a la misma política.

## Paso 5 — El monto solicitado

Cuando la integración indica cuánto quiere canjear (`amountToRedeem`), ese monto limita el canje. Cada política se evalúa con el monto solicitado completo y solo después se elige la ganadora, así que una política que pierde no reduce el monto de la que gana.

## Ejemplos

En los ejemplos, los pedidos no tienen tope de porcentaje salvo que se indique, y las políticas aplican en la tienda del pedido.

| # | Saldo del cliente | Resultado | Por qué |
|---|---|---|---|
| 1 | Política A (agregar): cards de $100 y $50. Política B (agregar): card de $120. | **$150**, de A | A suma $150 y B suma $120. Las políticas compiten: gana la mayor. |
| 2 | Política A (agregar): $30 + $30. Política B (único): $50. | **$60**, de A | A suma $60; B usa un card de $50. Gana A. |
| 3 | Igual al ejemplo 2, con `amountToRedeem` = $60. | **$60**, de A | Cada política se evalúa con los $60 completos; A cubre los $60. |
| 4 | Política M (mixto): $50. Política A (agregar): $100. | **$100**, de A | Mixto no se suma con otra política; gana el mayor descuento. |
| 5 | Política M1 (mixto): $40. Política M2 (mixto): $70. | **$70**, de M2 | Aunque las dos estén en mixto, políticas diferentes no se suman. |
| 6 | Política A: $80, vence en diciembre. Política B: $80, vence en noviembre. | **$80**, de B | Empate en el descuento: gana la vigencia más próxima. |
| 7 | Política A (agregar): $10 + $20 + $30. | **$60** | Dentro de la misma política, agregar suma todos los cards. |
| 8 | Política B (único): $10, $20 y $30. | **$30** | Dentro de la misma política, único usa solo el mejor card. |
| 9 | Pedido de $1,000. Política A (agregar, máx. 30%): $500. Política B (agregar, sin tope): $200. | **$300**, de A | El tope de A la limita a $300 (30% de $1,000), que sigue siendo mayor que los $200 de B. |

## Preguntas frecuentes

**El cliente tiene más saldo del que pudo canjear. ¿Por qué?**
Las causas más comunes son el saldo dividido en políticas diferentes (solo una se usa por pedido, paso 4), el tope de la política (paso 2) o el modo Único (paso 3). Si `redeemable.blocked` viene lleno, una cartera fue bloqueada por el mínimo dinámico (paso 1).

**Quiero que el cashback de dos campañas se sume en el mismo pedido.**
Coloque las dos campañas en la **misma** política de canje, en modo Agregar.

**Quiero que el cliente use solo el mejor crédito, uno por pedido.**
Use el modo **Único** en la política.

## Historial

- **3 de octubre de 2026** — las políticas diferentes pasaron a competir entre sí. Antes, los cards de políticas diferentes en modo Agregar o Mixto se sumaban en el mismo pedido.

## Vea también

- [Recompensa por pedido](/docs/{lang}/api-reference/loyalty/checkout/reward-by-order)
- [Confirmar pedido](/docs/{lang}/api-reference/loyalty/checkout/confirm-order-by-confirmtoken)
- [Actualizar transacción](/docs/{lang}/api-reference/loyalty/checkout/update-transaction)
- [Cancelación en loyalty](/docs/{lang}/guides/loyalty-cancellation)
