Entrar

Acumulación por pedido

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

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)

Modes

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

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.

Cuerpo de la petición

Content-Type: application/json

{
    "interface": "generic",
    "storeId": "1",
    "checkoutId": "ck_demo_a1b2-c3d4",                          // optional
    "purchaseType": "delivery",                                 // optional
    "client": {                                                 // optional
        "id": "123123",                                         // optional
        "name": "Tintim",                                       // optional
        "document": "32165987",                                 // optional
        "email": "tintim@guper.co",                             // optional
        "countryCallingCode": 55,                               // optional
        "cellphone": "19954264546"                              // optional
    },
    "attendants": {                                             // optional
        "cashier": {                                            // optional
            "id": "123"
        },
        "salesperson": {                                        // optional
            "id": "342"
        }
    },
    "items": [
        {
            "id": "1",                                          // SKU id
            "productId": "1",                                   // optional
            "name": "Smartphone Guper MK1",
            "categoryId": "20",                                 // optional
            "brandId": "20",                                    // optional
            "sellerId": "1",                                    // optional
            "tax": 1232,                                        // optional, cents
            "quantity": 1,                                      // int ≥ 1
            "price": 96390,                                     // cents
            "listPrice": 100000                                 // optional, cents
        }
    ],
    "shipping": [                                               // optional
        {
            "id": "AA123456785BR",
            "courierId": "correios-br",
            "courierName": "Correios",
            "price": 2000,                                      // cents
            "listPrice": 2000                                   // optional, cents
        }
    ]
}

Respuestas

{
    "organization": "acme",
    "interface": "generic",
    "customerId": 708,
    "cashback": {
        "thisOrder": {
            "redeemable": {
                "total": 522,
                "item": [{ "id": "1", "value": 522 }]
            },
            "accumulating": {
                "total": 4819,
                "item": [{ "id": "1", "value": 4819 }]
            }
        },
        "userBalance": { "total": 0, "availableAmount": 0 }
    },
    "confirmToken": "54eb6281f4e3e13671a5e4c95609f4a69247a5f38d01bef99768399bb6645c49",
    "smartpos": "https://acme.myguper.com/smartpos/54eb6281f4e3e13671a5e4c95609f4a69247a5f38d01bef99768399bb6645c49",
    "expiresAt": "2024-05-21T11:21:27-03:00",
    "dateTime": "2024-05-21T10:51:27-03:00"
}

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.

Copied to clipboard