Skip to main content

Producten, Velden & Modules

Producten

Producten zijn de betaalbare items binnen een activiteit — tickets, merchandise, diensten, enz.

Product aanmaken

POST /api/v1/{team}/activities/{activity}/products — 🔒 authenticatie vereist

Veld Type Verplicht Omschrijving
name string ✓ Naam van het product
price number ✓ Prijs in euro (gebruik 0 voor gratis)
description string   Omschrijving
available_places integer   Maximum aantal beschikbare plaatsen
min_amount integer   Minimum aantal per bestelling
max_amount integer   Maximum aantal per bestelling
is_ticket boolean   true als dit product een ticket genereert
amount_of_tickets integer   Aantal tickets per product
vat_rate number   BTW-percentage (bijv. 21)
price_is string   incl of excl BTW
curl -X POST https://app.payit.be/api/v1/{team}/activities/{activity}/products \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "VIP Ticket",
    "price": 49.99,
    "is_ticket": true,
    "available_places": 100
  }'

Respons 201 Created — geeft het aangemaakte product terug inclusief id en position.


Product bijwerken

PATCH /api/v1/{team}/activities/{activity}/products/{product} — 🔒 authenticatie vereist

Stuur alleen de velden mee die je wilt wijzigen.

curl -X PATCH https://app.payit.be/api/v1/{team}/activities/{activity}/products/{product} \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "price": 59.99,
    "available_places": 150
  }'

Respons 200 OK — geeft het bijgewerkte product terug.


Product verwijderen

DELETE /api/v1/{team}/activities/{activity}/products/{product} — 🔒 authenticatie vereist

curl -X DELETE https://app.payit.be/api/v1/{team}/activities/{activity}/products/{product} \
  -H "Authorization: Bearer <access_token>"

Respons 204 No Content


Velden

Velden zijn de formuliervragen die deelnemers invullen bij inschrijving.

Velden ophalen

GET /api/v1/{team}/activities/{activity}/fields — 🔒 authenticatie vereist

curl -X GET https://app.payit.be/api/v1/{team}/activities/{activity}/fields \
  -H "Authorization: Bearer <access_token>"

Respons 200 OK

{
  "results": [
    {
      "id": "f1e2d3c4-...",
      "type": "text",
      "label": "Naam deelnemer",
      "value": null,
      "required": true,
      "repeatable": false,
      "position": 1
    },
    {
      "id": "f2e3d4c5-...",
      "type": "dropdown",
      "label": "T-shirt maat",
      "value": "S\nM\nL\nXL",
      "required": false,
      "repeatable": false,
      "position": 2
    }
  ]
}

Veld aanmaken

POST /api/v1/{team}/activities/{activity}/fields — 🔒 authenticatie vereist

Veld Type Verplicht Omschrijving
type string ✓ Veldtype (zie lijst hieronder)
label string ✓ Vraag of label
required boolean   Verplicht invullen (standaard: false)
repeatable boolean   Herhaalbaar per deelnemer (standaard: false)
value string   Opties voor dropdown (ÊÊn per regel)

Beschikbare veldtypes:

Type Omschrijving
text Korte tekst
textbox Lange tekst
email E-mailadres
number Getal
date Datum
dropdown Keuzelijst (opties in value, gescheiden door newlines)
checkbox Aanvinkvakje
file Bestandsupload
curl -X POST https://app.payit.be/api/v1/{team}/activities/{activity}/fields \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "dropdown",
    "label": "T-shirt maat",
    "value": "S\nM\nL\nXL",
    "required": true
  }'

Respons 201 Created — geeft het aangemaakte veld terug inclusief id en position.


Veld bijwerken

PATCH /api/v1/{team}/activities/{activity}/fields/{field} — 🔒 authenticatie vereist

Stuur alleen de velden mee die je wilt wijzigen.

curl -X PATCH https://app.payit.be/api/v1/{team}/activities/{activity}/fields/{field} \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"required": true}'

Respons 200 OK


Veld verwijderen

DELETE /api/v1/{team}/activities/{activity}/fields/{field} — 🔒 authenticatie vereist

curl -X DELETE https://app.payit.be/api/v1/{team}/activities/{activity}/fields/{field} \
  -H "Authorization: Bearer <access_token>"

Respons 204 No Content


Modules

Modules zijn optionele functionaliteiten die je per activiteit kunt inschakelen, zoals ticketing, een kalender of beschikbare plaatsen.

Ingeschakelde modules ophalen

GET /api/v1/{team}/activities/{activity}/modules — 🔒 authenticatie vereist

{
  "results": [
    {
      "id": 12,
      "module_id": 3,
      "slug": "ticket",
      "name": "Ticket System",
      "price_excl": 0.00,
      "price_incl": 0.00,
      "created_at": "2026-01-10T09:00:00.000000Z"
    }
  ]
}

Module inschakelen

POST /api/v1/{team}/activities/{activity}/modules — 🔒 authenticatie vereist

Veld Type Verplicht Omschrijving
module_id integer ✓ ID van de module
curl -X POST https://app.payit.be/api/v1/{team}/activities/{activity}/modules \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"module_id": 3}'

Respons 201 Created


Module uitschakelen

DELETE /api/v1/{team}/activities/{activity}/modules/{module} — 🔒 authenticatie vereist

curl -X DELETE https://app.payit.be/api/v1/{team}/activities/{activity}/modules/{module} \
  -H "Authorization: Bearer <access_token>"

Respons 204 No Content