En este documento se describe la diferencia entre las respuestas de una venta sin spin premia y de una venta con spin premia.
El objeto principal conserva la estructura base utilizada en versiones anteriores. La principal
modificación consiste en la incorporación de dos nuevos objetos dentro del JSON para aquellas
transacciones que involucren procesos asociados a SPIN Premia, como la acumulación o redención
de puntos. Estos objetos son: "spinPremia" y "summary"
.
El objeto "spinPremia" encapsulará la información específica del proceso SPIN Premia,
dependiendo del tipo de transacción. Por su parte, el objeto "summary" contendrá un desglose
detallado de los montos involucrados, incluyendo los puntos redimidos a través del programa SPIN
Premia y el importe pagado mediante tarjeta bancaria.
Este diseño está concebido con miras a una escalabilidad futura, permitiendo la integración de
funcionalidades adicionales como mecanismos de cashback u otros servicios complementarios.
En la siguiente tabla se muestra cuando la respuesta JSON contiene los objetos spinPremia
y summary dependiendo del tipo de transacción.
| Tipo de Transacción | spinPremia | summary |
|---|---|---|
| Sin Spin Premia | ❌ | ❌ |
| Con Spin Premia (sin acum/redención) | ❌ | ❌ |
| Con Spin Premia (con acum/redención) | ✔ | ✔ |
| Venta con MSI | ❌ | ❌ |
| Check-In | ❌ | ❌ |
Objeto Spin Premia
Este objeto contiene la información y los datos de la transacción cuando se usó puntos ya sea para
acumular o redimir estos campos son los siguientes.
| Nombre del Campo | Descripción | Tipo de dato |
|---|---|---|
| mediumCode | Número de la tarjeta física o digital spin premia | TEXT |
| redeemAmount | Cantidad en dinero que se usó para redimir | DOUBLE as TEXT |
| redeemPoints | Cantidad de puntos usados en la redención | DOUBLE as TEXT |
| stockpileBalance | Balance de puntos premia | Num as TEXT |
| stockpilePoints | Puntos acumulados | Num as TEXT |
| stockpileTicketId | Id de la trx de acumulación | TEXT |