Entrar

Canje: Reservar

POST https://{organization}.myguper.com/api/loyalty/redeem/reserve/{hash}

Reserva el monto canjeable de una promesa de reward calculada previamente (el hash/confirmToken devuelto por Acumulación por pedido). La reserva entra en waitSettlement y retiene los puntos en el saldo del cliente hasta la confirmación del pedido (reserved → cancelled o redeemed vía Settle).

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
hash * string Confirmation token returned by Reward by Order.

Cuerpo de la petición

Content-Type: application/json

{
    "refId": "<refId>",                                         // optional
    "reserve": 0,                                               // optional, cents
    "couponCode": "<couponCode>"                                // optional
}

Respuestas

{
    "organization": "acme",
    "person":       184532,
    "redeem":       { "reserved": 1500 },
    "dateTime":     "2026-08-27T18:12:31-03:00"
}

Relacionados

Copied to clipboard