Acumulación por pedido
Calcula el cashback que un pedido puede acumular. Este endpoint opera en dos modos: Privado y Público. Elige el modo según tu caso de uso.
Try-it values populated from environment ACME (Demo)
Devuelve datos del cliente, información de canje disponible y un
token de confirmación que puede usarse después en confirmOrder.
Requiere un token de usuario válido.
Autenticación
Token
Send your user token in the x-guper-authorization header. Endpoints that
support a Public mode (e.g. acúmulo and resgate previews) accept the same
request without the header — Private mode adds customer data and a
confirmation token to the response.
Encabezados
Cuerpo de la petición
Content-Type:
application/json
Respuestas
Notas
Canje bloqueado por la regla de la cartera. Cuando la cartera tiene mínimo
dinámico (minOrderRate), el saldo del cliente solo puede usarse si el pedido
vale N veces ese saldo — 3 con saldo de $30.00 exige una compra de $90.00.
Es todo o nada: por debajo de eso no canjea nada, ni una parte.
En ese caso redeemable.total regresa 0 y redeemable.blocked dice por qué:
"redeemable": {
"total": 0,
"item": [],
"blocked": [
{
"wallet": 60,
"reason": "minOrderRate",
"rate": 3,
"balance": 3000,
"required": 9000,
"missing": 1500
}
]
}
wallet es el id de la política, rate el multiplicador, balance el saldo
considerado, required cuánto tendría que valer el pedido y missing lo que
falta (required − total del pedido). Montos en centavos.
El saldo queda intacto — userBalance lo sigue mostrando, y el mismo cliente
canjea normalmente en un carrito mayor. Muestre el missing: "faltan $15.00
para usar tu saldo". El mismo bloque aparece en
Actualizar transacción,
que vuelve a aplicar la regla cuando el carrito cambia.