Entrar

Adicionar pontos

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

Adiciona uma entrada de pontos de tier para uma pessoa. O saldo e o nível são recalculados imediatamente. Use source: rewardCampaign (com o sourceId da transação correspondente) quando os pontos vêm de um evento de loyalty, ou source: manual para ajustes operacionais.

Try-it values populated from environment ACME (Demo)


Autenticação

Token

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

Cabeçalhos

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

Name Type Description
personId * integer ID interno da pessoa no Guper.

Corpo da requisição

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
}

Respostas

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