Entrar

Crear referido

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

Registra una relación de quién-refirió-a-quién entre dos clientes. Cada person solo puede tener un referidor activo a la vez:

  • Si no existe referido para person, se crea uno nuevo.
  • Si ya existe un referido activo (expiredAt > ahora), el endpoint rechaza cambiar el referrer (HTTP 409). Enviar el mismo referrer con un nuevo expiredAt solo extiende la vigencia.
  • Si el referido existente ya expiró, el nuevo payload lo reemplaza.

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.

Cuerpo de la petición

Content-Type: application/json

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

Respuestas

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