Endpoint de validación (POST)

Crowder envía un request POST a {baseUrl}/validate para validar el código ingresado por el cliente.

Request

POST {baseUrl}/validate
Content-Type: application/json
apiKey: <tu_api_key>

Payload:

{
  "code": "string",
  "quantity": 0,
  "consume": false,
  "rate": {
    "id": 0,
    "name": "string"
  },
  "product": {
    "id": 0,
    "name": "string"
  },
  "event": {
    "id": 0,
    "name": "string"
  }
}

Campos

Campo	Tipo	Descripción
code	string	Código ingresado por el cliente.
quantity	number	Cantidad de unidades a las que se aplica el código.
consume	boolean	false durante la validación inicial; true cuando se está efectivizando la reserva.
rate	object	Tarifa seleccionada (id, name).
product	object	Producto seleccionado (id, name).
event	object	Evento al que pertenece la compra (id, name).

Sobre la propiedad consume

La propiedad consume indica el momento del flujo:

• consume: false → fase de validación inicial (el cliente está revisando el código antes de pagar).
• consume: true → la reserva se está efectivizando. Si llevás control de uso de códigos, este es el momento de marcarlo como consumido.

Response

La API debe responder con el siguiente formato:

{
  "valid": true,
  "message": "string"
}

Campo	Tipo	Descripción
valid	boolean	true si el código es válido y la compra puede continuar; false para rechazarlo.
message	string	Mensaje a mostrar al cliente. Solo tiene sentido cuando valid es false.