Skip to main content

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_url om 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"
}