Entrar

Actualizar transacción

POST https://{organization}.myguper.com/api/loyalty/updateTransaction/{confirmToken}

Actualiza una transacción pendiente (ítems, totales, cliente, pagos) antes de la confirmación. Recalcula el cashback canjeable y el que se acumulará para que el próximo confirmOrder use los nuevos valores.

Tanto recalculateReward como recalculateRedemption tienen default true — ponlos en false para mantener el cálculo original cuando envíes solo cambios de metadatos (ej.: actualizar ítems sin volver a correr las reglas de cashback). Los campos monetarios (price, listPrice, tax, amountToRedeem) se envían como enteros en centavos — véase Valores monetarios.

Try-it values populated from environment ACME (Demo)


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

Name Type Description
x-guper-authorization * string User token issued by Guper. Omit only on endpoints that explicitly support a Public mode.
Content-Type * string Always `application/json` for endpoints that accept a JSON body.

Parámetros de ruta

Name Type Description
confirmToken * string Token devuelto por Acumulación por pedido. Identifica la predicción pendiente a actualizar.

Cuerpo de la petición

Content-Type: application/json

{
    "recalculateReward": true,                                  // optional
    "recalculateRedemption": true,                              // optional
    "amountToRedeem": null,                                     // optional, cents
    "items": [                                                  // optional
        {
            "skuId": "1",                                       // optional
            "quantity": 1,                                      // optional
            "price": 90000,                                     // optional, cents
            "listPrice": 100000,                                // optional, cents
            "tax": 1232                                         // optional, cents
        }
    ],
    "payments": "<payments>"                                    // optional
}

Respuestas

{
    "organization": "xpto",
    "interface": "generic",
    "customerId": 2157344,
    "cashback": {
        "thisOrder": {
            "redeemable": {
                "total": 55059,
                "item": [
                    { "skuId": "2",  "value": 18353 },
                    { "skuId": "10", "value": 18353 },
                    { "skuId": "10", "value": 18353 }
                ]
            },
            "accumulating": {
                "total": 54464,
                "item": [
                    { "skuId": "2",  "value": 18155 },
                    { "skuId": "10", "value": 18155 },
                    { "skuId": "10", "value": 18154 }
                ]
            }
        },
        "userBalance": { "total": 55059, "availableAmount": 54464 }
    },
    "coupon": [],
    "confirmToken": "ca93b522eb10c42dff16ce8d5b3ad86d962a610184db68643158eec9bb10747f",
    "expiresAt": "2025-07-25T00:52:14-06:00",
    "smartpos": "https://xpto.myguper.com/smartpos/ca93b522eb10c42dff16ce8d5b3ad86d962a610184db68643158eec9bb10747f",
    "dateTime": "2025-07-24T12:52:14-06:00"
}

Notas

Las reglas de la cartera se vuelven a aplicar al nuevo carrito. Si la cartera tiene mínimo dinámico (minOrderRate) y el carrito bajó de ese umbral, el canje ya reservado se cae: redeemable.total regresa 0 con redeemable.blocked explicando por qué (mismo formato de Acumulación por pedido).

Cobre siempre al cliente por el redeemable.total de esta respuesta — no por el que se cotizó antes de que el carrito cambiara.

Copied to clipboard