Entrar

Atualizar transação

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

Atualiza uma transação pendente (itens, totais, cliente, pagamentos) antes da confirmação. Recalcula o cashback resgatável e a acumular para que o próximo confirmOrder use os novos valores.

Tanto recalculateReward quanto recalculateRedemption têm default true — defina-os como false para manter o cálculo original quando enviar apenas mudanças de metadados (ex.: atualizar itens sem rodar de novo as regras de cashback). Campos monetários (price, listPrice, tax, amountToRedeem) são enviados como inteiros em centavos — veja Valores monetários.

Try-it values populated from environment ACME (Demo)


Autenticação

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.

Cabeçalhos

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 do caminho

Name Type Description
confirmToken * string Token retornado por Acúmulo por pedido. Identifica a predição pendente a atualizar.

Corpo da requisição

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
}

Respostas

{
    "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

As regras da carteira são reaplicadas ao novo carrinho. Se a carteira tem mínimo dinâmico (minOrderRate) e o carrinho encolheu abaixo dele, o resgate já reservado cai: redeemable.total volta 0 com redeemable.blocked explicando o porquê (mesmo formato de Acúmulo por pedido).

Cobre sempre o cliente pelo redeemable.total desta resposta — não pelo que foi cotado antes de o carrinho mudar.

Copied to clipboard