Inschrijvingen & Tickets
Inschrijvingen
Een inschrijving is een registratie van een deelnemer voor een activiteit, gekoppeld aan een of meerdere producten.
Inschrijvingen ophalen
GET /api/v1/{team}/activities/{activity}/subscriptions â đ authenticatie vereist
Geeft alleen betaalde inschrijvingen terug.
| Parameter | Locatie | Omschrijving |
|---|---|---|
email |
query | Filter op e-mailadres |
page |
query | Paginanummer |
curl -X GET "https://app.payit.be/api/v1/{team}/activities/{activity}/subscriptions?email=jan" \
-H "Authorization: Bearer <access_token>"
Respons 200 OK
{
"results": [
{
"id": "s1u2b3s4-...",
"email": "[email protected]",
"price": 49.99,
"is_paid": true,
"created_at": "2026-03-10T14:00:00.000000Z",
"updated_at": "2026-03-10T14:05:00.000000Z"
}
],
"pagination": { ... }
}
Inschrijving ophalen
GET /api/v1/{team}/activities/{activity}/subscriptions/{subscription} â đ authenticatie vereist
Geeft de volledige details inclusief formulierdata en producten.
{
"id": "s1u2b3s4-...",
"email": "[email protected]",
"price": 49.99,
"is_paid": true,
"fields": [
{ "name": "Naam deelnemer", "value": "Jan Janssen" },
{ "name": "T-shirt maat", "value": "L" }
],
"products": [
{ "name": "VIP Ticket", "amount": 1, "price": 49.99, "is_ticket": true }
],
"created_at": "2026-03-10T14:00:00.000000Z",
"updated_at": "2026-03-10T14:05:00.000000Z"
}
Inschrijving aanmaken
POST /api/v1/{team}/activities/{activity}/subscriptions â đ authenticatie vereist
Maak een nieuwe inschrijving aan voor een deelnemer. Als de totaalprijs 0 is, wordt de inschrijving automatisch als betaald gemarkeerd.
Request body
| Veld | Type | Verplicht | Omschrijving |
|---|---|---|---|
email |
string | â | E-mailadres van de deelnemer |
products |
array | â | Lijst van producten (zie hieronder) |
fields |
array | Â | Ingevulde formuliervelden |
callback_url |
string | Â | URL die aangeroepen wordt na betaling |
Producten (verplicht):
"products": [
{ "id": "p1r2o3d4-...", "amount": 2 }
]
Velden (optioneel):
"fields": [
{ "field_id": "f1e2d3c4-...", "value": "Jan Janssen" },
{ "field_id": "f2e3d4c5-...", "value": "L" }
]
Volledig voorbeeld
curl -X POST https://app.payit.be/api/v1/{team}/activities/{activity}/subscriptions \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"products": [
{ "id": "p1r2o3d4-...", "amount": 1 }
],
"fields": [
{ "field_id": "f1e2d3c4-...", "value": "Jan Janssen" }
],
"callback_url": "https://mijnapp.be/webhook/betaling"
}'
Respons 201 Created â geeft de volledige inschrijving terug.
Betaalintentie aanmaken
POST /api/v1/{team}/subscriptions/{subscription}/payment-intent â đ authenticatie vereist
Maak een betaalintentie aan voor een onbetaalde inschrijving. Dit initieert het betaalproces via de geconfigureerde betaalprovider (Stripe, Mollie, âĻ).
Als de prijs 0 is, wordt de inschrijving direct als betaald gemarkeerd.
| Veld | Type | Omschrijving |
|---|---|---|
callback_url |
string | URL voor betaalbevestiging (optioneel) |
curl -X POST https://app.payit.be/api/v1/{team}/subscriptions/{subscription}/payment-intent \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"callback_url": "https://mijnapp.be/betaald"}'
Respons 200 OK
{
"payment_url": "https://checkout.stripe.com/pay/cs_test_...",
"subscription_id": "s1u2b3s4-..."
}
Stuur de gebruiker door naar
payment_urlom de betaling te voltooien.
PDF downloaden
GET /api/v1/{team}/subscriptions/{subscription}/pdf â đ authenticatie vereist
Download de bevestigings-PDF voor een betaalde inschrijving. Retourneert een application/pdf-bestand.
curl -X GET https://app.payit.be/api/v1/{team}/subscriptions/{subscription}/pdf \
-H "Authorization: Bearer <access_token>" \
--output bevestiging.pdf
Foutgevallen:
| Status | Oorzaak |
|---|---|
422 |
Inschrijving is nog niet betaald |
403 |
Je bent geen lid van dit team |
404 |
Inschrijving hoort niet bij dit team |
Tickets
Tickets worden automatisch aangemaakt wanneer een product met is_ticket: true betaald is.
Tickets ophalen
GET /api/v1/{team}/activities/{activity}/tickets â đ authenticatie vereist
curl -X GET https://app.payit.be/api/v1/{team}/activities/{activity}/tickets \
-H "Authorization: Bearer <access_token>"
Respons 200 OK
{
"results": [
{
"id": "t1i2c3k4-...",
"email": "[email protected]",
"product_name": "VIP Ticket",
"is_scanned": false,
"scanned_at": null
}
],
"pagination": { ... }
}
Ticket ophalen
GET /api/v1/{team}/activities/{activity}/tickets/{ticket} â đ authenticatie vereist
Geeft de details van ÊÊn ticket terug (zelfde structuur als hierboven).
Ticket scannen
POST /api/v1/{team}/activities/{activity}/tickets/{ticket} â đ authenticatie vereist
Markeer een ticket als gescand of zet het terug op niet-gescand.
| Veld | Type | Verplicht | Omschrijving |
|---|---|---|---|
is_scanned |
boolean | â | true = gescand, false = terugzetten |
curl -X POST https://app.payit.be/api/v1/{team}/activities/{activity}/tickets/{ticket} \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"is_scanned": true}'
Respons 200 OK
{
"id": "t1i2c3k4-...",
"email": "[email protected]",
"product_name": "VIP Ticket",
"is_scanned": true,
"scanned_at": "2026-06-15T11:34:22.000000Z"
}