Close (toegangscontrole-app)

Close is een externe toegangscontrole-app (closeapi.nl) die tickets via een eigen barcode-scanner-app valideert. Deze koppeling stuurt bij elke betaalde bestelling de ticketgegevens door naar Close zodat hun app ze kan scannen bij de deur.

Admin-only. Deze koppeling is standaard niet zichtbaar in het menu. Alleen beheerders met admin-rechten kunnen deze instellen. Vraag support als je deze koppeling wil activeren.

Wanneer gebruik je dit

• Je organisatie gebruikt de Close-app voor deurcontrole in plaats van (of naast) de standaard VoordeMensen scan-app.
• Je hebt al een account bij closeapi.nl met client_id, client_secret en access_token.

Hoe het werkt

Zodra een bestelling in VoordeMensen op betaald gaat (OrderPaid-event), kijkt het systeem of er Close-koppelingen zijn voor de events in die bestelling. Per match stuurt het de tickets door naar Close:

POST https://partner.closeapi.nl/api/v1/tickets/import
Authorization: Bearer <close_access_token>
{
  "clev": "<close_event_id>",
  "ticket_group": {
    "contact_phone_number": "...",
    "tickets": [
      { "scan_code": "...", "product_title": "...", "product_description": "...",
        "seat_info": { "main_entrance": "..." },
        "event_start_date_time": "..." }
    ]
  }
}

Configuratie (shopconfig)

Voor de koppeling werkt heeft je shopconfig drie sleutels nodig (zet support/beheer):

Sleutel	Uitleg
close_client_id	Client-ID bij closeapi.nl
close_client_secret	Client-secret bij closeapi.nl
close_access_token	OAuth access-token

Events koppelen

Voor elk VoordeMensen-event dat je naar Close wil pushen, maak je een koppelregel:

Veld	Wat invullen
Omschrijving	Interne naam (bv. "Festival 2026 — Close")
Close CLEV	De Event-ID bij closeapi.nl (verkrijg je via je Close-portal)
Evenement	Het VoordeMensen-event dat gekoppeld moet worden

Wat gaat er mee

Per ticket stuurt het systeem:

• scan_code — VoordeMensen barcode (V + seat_id gepadded + seat_code).
• product_title — Event-naam.
• product_description — Discount/kaartsoort-naam.
• seat_info.main_entrance — Locatie-naam (ort_name).
• event_start_date_time — ISO 8601-timestamp van event-start.
• contact_phone_number — Telefoonnummer van de besteller (gedeeld voor hele order).

Let op

• Push gebeurt alleen bij OrderPaid — handmatig gemaakte of nog niet betaalde bestellingen worden niet doorgestuurd.
• Hoofd- en sub-events — zowel het hoofd-event (event_id) als sub-events met event_main_id = <gekoppeld event> worden meegenomen.
• Één koppeling per event is voldoende; maak geen duplicaten.

Tips

• Test eerst met één event en een test-bestelling voor je grote events koppelt.
• Bij fouten check de Laravel-log (tickets:storage/logs/laravel.log) op 401/403-responses van closeapi.nl — meestal is je access-token verlopen.

---

Zie ook: API-keys · Webhooks · Overzicht integraties