Entrar

Criar indicação

POST https://{organization}.myguper.com/api/register/customer/referral

Registra uma relação de quem-indicou-quem entre dois clientes. Cada person só pode ter um indicador ativo por vez:

  • Se não existir indicação para person, uma nova é criada.
  • Se já existir indicação ativa (expiredAt > agora), o endpoint recusa trocar o referrer (HTTP 409). Enviar o mesmo referrer com novo expiredAt apenas estende a vigência.
  • Se a indicação existente já estiver expirada, o novo payload a substitui.

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.

Corpo da requisição

Content-Type: application/json

{
    "person": 620287,
    "referrer": 609961,
    "expiredAt": "2026-12-31 23:59:59"
}

Respostas

{
    "person": 620287,
    "referrer": 609961,
    "expiredAt": "2026-12-31T23:59:59-03:00",
    "createdAt": "2026-05-03T10:00:00-03:00"
}
Copied to clipboard