Entrar

Agregar puntos

POST https://{organization}.myguper.com/api/register/person/{personId}/tier/points

Agrega una entrada de puntos de tier a una persona. El saldo y el nivel se recalculan de inmediato. Usa source: rewardCampaign (con el sourceId de la transacción correspondiente) cuando los puntos vienen de un evento de loyalty, o source: manual para ajustes operativos.

Try-it values populated from environment ACME (Demo)


Autenticación

Token

Send your user token in the x-guper-authorization header.

Encabezados

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

Parámetros de ruta

Name Type Description
personId * integer ID interno de la persona en Guper.

Cuerpo de la petición

Content-Type: application/json

{
    "source": "rewardCampaign",
    "sourceId": "tx_demo_a1b2c3d4",                             // optional
    "value": 150,                                               // points
    "expireAt": "2027-05-01T00:00:00-03:00",                    // optional
    "description": "Cashback ord_2026_001"                      // optional
}

Respuestas

{
    "success":      true,
    "pointsAdded":  150,
    "source":       "rewardCampaign",
    "activePoints": 2350
}
Copied to clipboard