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