MATCHi integration
For clubs that take bookings in MATCHi: a MATCHi booking takes the court in AISOLUS, starts recording and scoring on court by the booking time, and highlights and stats reach the players.
Ready to connect The integration is built and covered by automated tests, but not yet switched on at any club. It is enabled per club with a MATCHi event subscription.
How it works
MATCHi does not serve bookings on request — it pushes events: booking created, moved, cancelled (Matchi Event Portal, event versions V1 and V2). Each event immediately creates, moves or cancels the court booking in AISOLUS: the court is never sold twice, recording on court starts by the booking, highlights and stats go to the players.
- Authenticity. An event is accepted only if the
x-matchi-signatureheader (HMAC-SHA256 of the body with the subscription secret) matches the club secret. A redelivery with the same event id is not executed twice. - Courts. A MATCHi court is matched to a club court by name (“Court 1”, “Bana 1” and “Pista 1” are the same court) or manually in the club panel, where MATCHi courts appear with the first bookings.
- Time and players. MATCHi times arrive in UTC and are converted to club time. The player is a separate MATCHi player record keyed by the MATCHi customer id: the MATCHi phone is not verified, so a booking is never linked to someone else's account by number.
- Conflicts. If the slot is already taken by an AISOLUS booking, the MATCHi booking does not overwrite it — it goes to the conflict log in the club panel.
The endpoint is described in the API reference and in Swagger.
How to connect
- Tell your platform administrator that the club takes bookings in MATCHi: AISOLUS passes the club event endpoint to MATCHi support.
- MATCHi support creates the booking event subscription and issues the subscription secret.
- In the club panel, section “MATCHi integration”, enter the club ID in MATCHi (facilityId) and the subscription secret, and switch the link on.
- Match MATCHi courts to club courts if the names differ.
What the club needs to provide
- A MATCHi event subscription for the club bookings (arranged through MATCHi support).
- The list of courts in MATCHi and which of them have AISOLUS cameras.
- Player consent to receive recordings — in the club rules or at booking.
- A technical contact at the club.